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1  INTRODUCTION:  MCC  CSCI  DESCRIPTION 
1 . 1  Background 

As  the  distributed  simulation  concept  developed  from  several  vehicle  simulators  to  several 
dozen  vehicle  simulators  it  became  evident  that  a  method  for  including  support  units  had  to 
be  developed.  In  addition,  as  the  exercises  derived  for  the  many  vehicle  simulators 
increased  in  complexity  it  was  recognized  that  a  centralized  method  for  initializing  these 
vehicles  would  be  useful. 

The  purpose  of  the  Management,  Command,  and  Control  System  (MCC)  is  to  fulfill  the 
dual  role  of  providing  support  units  to  the  maneuver  force  and  assisting  in  exercise  set-up. 

Each  support  element  is  represented  by  a  support  console.  The  support  console  provides  a 
graphic^  user  interface  to  the  individual  responsible  for  coordinating  the  activity  between 
tile  suppon  element  and  the  maneuver  force.  Support  elements  that  are  represented  include 
logistics,  maintainance,  fire  support  and  close  air  support.  For  example  the  Air  Liason 
Officer  uses  the  Close  Air  Support  console,  and  the  Fire  Support  Officer  uses  the  Fire 
Support  console.  The  console  operators  become  integral  to  the  exercise  and  are  participants 
just  as  the  vehicle  crew  members  are  participants. 

The  MCC  (Management,  Command  and  Control)  CSCI  is  used  in  setting  up  simulations 
and  simulating  elements  of  the  battlefield  environment.  It  keeps  track  of  the  condition  of 
the  various  manned  simulators  for  which  it  is  responsible  as  well  as  vehicles  that  it 
generates  for  service  and  repair.  It  also  handles  various  aspects  of  mine  laying.  In 
addition,  it  monitors  the  available  fuel  and  ammunition. 


1 . 2  External  Interfaces 

The  MCC  communicates  to  other  network  entities  across  the  SIMNET  network.  After  an 
exercise  is  developed,  the  MCC  is  used  to  initialize  the  position  and  status  of  the  individual 
vehicle  simulators.  This  is  accomplished  using  the  Activate  Request  Protocol  Data  Unit 
(PDU).  When  a  vehicle  simulator  receives  an  Activate  Request  PDU  it  uses  the  location 
information  to  place  itself  on  the  terrain  and  uses  the  status  information  to  initialize  internal 
status. 

The  majority  of  the  network  activity  that  the  MCC  participates  in  is  concerned  with  the 
Automated  Vehicles  that  the  MCC  simulates.  An  automated  vehicle  participates  in  network 
events  (i.e.  Collision,  Impact)  but  is  not  required  to  traverse  the  terrain.  These  simulations 
are  commenced  when  a  support  element  (i.e.  artillary  piece  for  fire  support)  is  requested. 

The  automated  vehicles  appear  as  stationary  vehicles  in  the  three  dimensional  vision  blocks 
of  the  vehicle  simulators.  This  automated  vehicle  concept  increases  the  realism  of  the 
exercise  by  providing  more  depth  to  the  simulated  environment.  The  reduced  complexity 
of  the  automated  vehicle  model  allows  multiple  models  to  be  simulated  by  a  single 
processor. 

The  MCC  CSCI  communicates  with  the  other  CSCls  over  SIMNET  using  Protocol  Data 
Units  (PDUs).  The  MCC  looks  for  (subscribes  to)  specific  PDUs  sent  out  by  the  other 
CSCls  and  broadcasts  PDUs  of  its  own.  This  communication  is  handled  by  the  Mother 
process  described  in  Section  2.1.  Below  is  Table  1.2-1  which  list  the  PDUs  that  are  of 
importance  to  the  MCC. 

I  - 
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PDU 

Protocol  Data 
Unit 


Activate 

Request 


Activate 

Response 


Deactivate 

Request 


Deactivate 

Response 


Vehicle 

Appearance 


CSCI 

Received 

From 


Vehicle 


Vehicle 


Vehicle 


Indirect  Fire 


Coilision 


Service 

Request 


Resupolv  Offer 


Resupply 

Received 


Resupply 

Cancel 


Repair  Request 


Marker 


Breached  Lane 
Status 


Vehicle 


Vehicle 


\msm 


Status  Query 


Status 

Response 


Status  Change 


Vehicle  Status  Vehicle 


Simulation 

Status 


Error  Report 


CSCI 
Sent  To 


Vehicle 


Vehicle 


In  Response  Protocol  Type 
To 


Vehicle 
needs  to  be 
activated 


Activate 

Request 


Vehicle 
needs  to  be 
deactivated 


Deactivate 

Request 


Update  or 
change 
vehicle 
appearance 


Directed  fire 


Impact  of 
direct  fire  from 
firinq  vehicle 


Non-direct  fire 


Vehicie 

collision 


Vehicle 
needs  fuel  or 
ammo 


Simulation 


Simulation 


Simulation 


Simulation 


Simulation 


Simulation 


Simulation 


Simulation 


Simulation 


Simulation 


Simulation 


Data 

Coliection 


Data 

Collection 


Data 

Collection 


Data 

Coliection 


Data 

Coliection 


Transaction 

Type 


Transaction 


Transaction 


Transaction  or 
Datagram 


Transaction 


Simulation  Datagram 


Simulation  I  Datagram 


Transaction  or 
Datagram 


Simulation  Datagram 


Simulation 


Simulation  I  Datagram 


Dataoram 


Datagram 


Simulation  I  Datagram 


Transaction 


Dataqram 


Datagram 


Dataqram 


Transaction  or 
Dataqram 


Transaction  or 
Dataqram 


Not  currently  used 


Table  1.2-1:  PDUs  used  by  the  MCC. 
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1.3  Internal  Structure 

The  MCC  is  composed  of  several  processors.  The  physical  interfaces  are  depicted  in  figure 
1.3-1.  The  MCC  host  communicates  to  a  bridge  console  via  an  RS-232  interface. 
Thebridge  routes  the  communication  between  the  Appletalk  network  containing  the  various 
support  consoles  and  the  RS-232  interface  to  the  MCC  host. 

The  processes  that  compose  the  MCC  are  shown  in  figure  1.3-2.  The  MCC  host  maintains 
a  central  process  called  the  mother  process  that  is  the  first  to  be  activated  when  the  MCC 
application  is  run.  The  mother  process  initializes  the  MCC  host  software  and  handles  the 
activity  relative  to  the  SIMNET  network.  Each  support  console  has  a  process  executing 
locally  on  the  Macintosh  that  handles  the  user  interface.  For  each  console  that  is  active,  a 
peer  process  is  activated  on  the  MCC  host.  Communication  is  directed  between  peers  by 
the  mother  process.  This  architecture  allows  the  consoles  to  be  run  independent  of  one 
another.  The  communication  between  these  processes  is  initiated  when:  the  support 
console  must  communicate  with  the  SIMNET  network;  floating  point  calculations  are  to  be 
made;  large  amounts  of  data  must  be  manipulated;  or  when  multiple  consoles  participate  in 
an  interaction. 

The  MCC  CSCI  is  composed  of  the  following  22  top-level  CSCs'; 

Mother  Process 
see  Process 
Place  Process 
Admin  Process 
Maint  Process 
FSE  Process 
CAS  Process 
CEW  Process 
Terminal  Process 

Masscomp  Communication  Software 

Bridge  Process 

Appletalk  Software 

see  Console 

Place  Console 

Admin  Console 

Maint  Console 

FSE  Console 

CAS  Console 

CEW  Console 

Network  Communication  Libraries 
MCC  Libraries 
Macintosh  Libraries 

Figure  1.3-3  Depicts  the  Architecture  of  this  CSCI. 

The  processes  which  run  on  the  Masscomp®  5600  workstation  communicate  among 
themselves  using  interprocess  messages.  There  are  tables  describing  these  messages  in  the 
appropriate  CSC  description.  The  processes  on  the  Masscomp®  5600  workstation 
communicate  with  their  corresponding  applications  on  the  Macintosh™  with  a 
communication  network  consisting  of  an  RS-232  cable,  the  Bridge  console  and  an 
Appletalk®  network.  This  is  fully  described  in  "The  SIMNET  Management,  Command 
and  Control  System"  document  mentioned  in  Section  1.1. 
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Figure  1.3-1:  Internal  Physical  Interface. 
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MCC  Libraries 


Mac  Software 
Libraries 
1.22 


Figure  1.3-3:  MCC  (Management,  Command  and  Control)  CSCI  Structure. 
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1.4  Configuration  and  Configuration  Management 

The  software  for  the  MCC  is  written  for  the  most  part  in  C.  The  software  for  the  CEW 
Console  is  written  in  C'*"''.  The  software  runs  on  a  Masscomp®  5600  workstation  and 
eight  Apple®  Macintosh™  personal  computers. 

SIMNET  software  for  the  Macintosh  is  organized  as  a  hierarchy  of  folders.  Most  software 
is  written  in  C  and  compiled  using  the  THINK  C  V4.0  compiler  by  Symantec.  Some 
developer-created  files  contain  not  C  source  code,  but  rather  Macintosh  "resources"  that 
describe  the  characteristics  of  a  user  interface,  such  as  the  layout  of  dialog  boxes.  These 
"resource  files"  are  created  and  maintained  using  the  Resource  Editor,  a  developers'  tool 
produced  by  Apple.  The  SIMNET  Macintosh  software  is  being  distributed  on  three 
Macintosh  BOOK  diskettes.  The  C  source  code  files  on  those  diskettes  can  be  examined 
using  any  Macintosh  text  editor  or  word  processor.  To  examine  the  resource  files,  one 
must  use  the  Apple  Resource  Editor. 

As  described  in  the  report,  "The  SIMNET  Management,  Command  and  Control  System", 
each  MCC  console  is  implemented  as  a  specialized  Macintosh  application  program.  Each 
of  these  six  programs  may  be  compiled  in  either  of  two  forms:  as  a  standalone,  demo 
program;  or  as  a  program  that  communicates  with  an  MCC  host  computer.  Conditional 
compilation  statements,  based  on  a  constant  called  "VERSION”,  determine  which  of  these 
two  versions  is  produced. 


1.5  Terminology  and  Documentation 

The  following  documents  provide  additional  information  about  the  MCC  system  and 
system- wide  communication: 

BBN  Report  No.  6473  -  The  SIMNET  Management,  Command  and  Control  System 
BBN  Report  No.  7102  -  The  SIMNET  Network  and  Protocols 
Top-level  Descriptions  for  SIMNET  Software,  May  1990 
Apple  Computer,  Inc.  "Inside  Appletalk",  1986 

Apple  Computer  Inc.  "Inside  Macintosh",  Volumes  1-4.  Addison-Wesley  Publishing 
Company.  Inc.  Reading,  Mass.,  1985,  1986. 
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2.1 


CSC  DESCRIPTIONS 
The  Mother  Process 


The  Mother  process  performs  a  wide  variety  of  tasks,  including  initializing  MCC  host 
software  at  the  start  of  an  exercise,  naodeling  CCVs,  positioning  vehicles,  activating  vehicle 
simulators,  recording  statistics,  listening  to  the  SIMNET  local  area  network  and  nx>nitoring 
the  MCC  system  as  a  whole.  It  handles  all  the  interprocess  communication  for  the  MCC 
and  also  handles  the  PDUs  that  are  sent  out  and  received  by  the  MCC  (except  for  Resupply 
Offer  and  Resupply  Clancel  which  are  sent  out  by  the  Admin  process).  Generally,  other 
CSCs  in  the  MCC  communicate  with  each  other  through  the  Mother  process.  Exceptions 
to  this  may  occur  when  the  SCC  sends  messages  to  other  CSCs  as  they  are  initialized,  and 
the  Terminal  process  also  sends  messages  as  required  by  commands  entered  on  the 
keyboard.  The  Mother  Process  structure  is  shown  in  Figure  2.1-1. 


Mother  Process 
1.1 


Initializing 

Modelling 

Positioning 

Activating 

Recording 

Listening 

Monitoring 

Minefield 

Software 

CCVs 

Vehicles 

Combat 

Statistics 

to  the 

MCC  System 

Simulation 

Vehicle 

SIMNET 

1.1.1 

1.1.2 

1.1.3 

Simulators 

1.1.5 

LAN 

1.1.7 

1.1.8 

1.1.4 

1.1.6 

—  soil.c 

—  data.c 

^cas.c 

1.1 .3.1 

L.  shutdown  .c 

—  maint.c 

— status.c 

— geometry.c 

1.1. 1.1 

1.1.2.1 

1. 1.5.1 

1. 1.6.1 

1. 1.7.1 

1. 1.8.1 

—  nriother.c 

_  popden.c 

—  actloc.c 

—  protocol  .c 

— vtimeout.c 

—  marker.c 

1.1.1.2 

1.1 .2.2 

1.1. 4.1 

1.1. 6.2 

1.1. 7.2 

1.1. 8.2 

_  param.c 

-jccv_modGl.c 

—  sirn.c 

_minefield.c 

1.1.1.3 

1.1. 2.3 

1.1. 4.2 

1.1. 8.3 

—  process.c 

—  fire.c 

1.1.1.4 

1.1 .2.4 

I—  vehicle.c  .-placement.c 
1..1.5  1.1. 2.5 

—ccv  change.c 
1.1. 2.6 


Figure  2.1-1:  Mother  Process  Structure. 
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The  Mother  process  is  further  broken  down  into  eight  (8)  second  level  CSCs  as  follows; 

Initializing  Software 
Modelling  CCVs 
Positioning  Vehicles 
Activating  Combat  Vehicle  Simulators 
Recording  Statistics 
Listening  to  the  SIMNET  LAN 
Monitoring  the  MCC  System 
Minefield  Simulation 


2.1.1  Initializing  MCC  Software 

This  second  level  CSC  initializes  the  global  data  structures  in  shared  memory  at  start-up  or 
whenever  the  exercise  is  recycled.  It  reads  values  in  from  a  parameter  file, 
/simnet/data/MCC-pars,  for  default  values  of  certain  variables.  It  also  initializes  the  network 
interface  and  spawns  the  other  service  processes  (Terminal,  ATSend  and  ATRecv).  When 
the  MCC  is  started,  it  also  spawns  the  SCC  process  which  in  turn  starts  the  SCC 
Macintosh  console.  It  initializes  hash  tables  to  store  information  received  from  appearance 
and  status  packets  (PDUs).  This  CSC  is  composed  of  the  following  CSUs: 

data.c 

mother.c 

param.c 

process.c 

vehicle.c 


2. 1.1.1  data.c 

/simnet/mcc/Mother/data.c 

data.c  contains  declarations  of  data  structures  used  throughout  the  Mother  process.  Table 
2.1-1  shows  the  these  structures. 


1  Variables 

Variable 

Type 

Where  Typedef  Declared 

mccTermination 

MCCTermination 

/simnet/mcc/Mother/mother.h 

exerciseLoqFile 

pointer  to  FILE 

Standard  C  type. 

vehicleLoaFile 

pointer  to  FILE 

Standard  C  type. 

howitzerShellCounter 

int 

Standard  C  type. 

mortarShellCounter 

int 

Standard  C  type. 

bombCounter 

int 

Standard  C  type. 

smokeParametersFilename 

array  maxFilenameLength  of 
char 

Standard  C  type. 

Table  2.1-1:  data.c  Variable  Information. 
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2. 1.1.2  mother.c 

/simnet/mcc/Mother/mother.c 


mother.c  is  the  top-level  module  of  the  MCC  Mother  process.  Table  2.1-2  describes  the 
variables  used  by  mother.c. 


Variables 


Variable 


Type 


Where  Typedef  Declared 


networkinterface 


extern  int 


Standard  C  type. 


activities 


array  of  Activity 


/simnet/mcc/Mother/mother.c 


PRIM 


pointer  to  char 


Standard  C  type. 


Table  2.1-2:  mother.c  Variable  Information. 

2. 1.1. 2.1  ProcessMessage 

ProcessMessage  handles  a  message  from  another  process,  type  indicates  whether  the 
message  is  a  one-way,  asynchronous  or  sychronous  request,  or  a  response  to  a  previous 
request,  kind  indicates  the  type  of  message  which  has  been  received,  length  indicates  the 
length  of  the  data  in  the  message  received,  msg  is  a  pointer  to  the  actual  message  data. 
Information  is  extracted  from  the  message  data  based  on  the  kind  of  message.  requestID  is 
a  unique  identifier  which  identifies  a  particular  request  which  requires  a  response.  The 
request  ID  is  used  when  replying  to  a  request  in  order  to  identify  which  request  the  reply  is 
for.  The  function  call  is  ProcessMessageftype,  kind,  length,  msg,  requestID).  Table  2.1-3 
describes  the  parameters  used,  errors  returned  and  functions  called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

AlarmsEnabled 

Section  2.21.2.4.4. 

tdb  init  cache 

Section  2.21.7.27.1. 

tdb  error 

Section  2.21.7.17.1. 

InitPopDenMap 

Section  2.1. 2.2.1. 

ActivateVehicle 

Section  2.1. 4.2.8. 

DeactivateVehicle 

Section  2.1.4.2.11. 

PlaceCCV 

Section  2. 1.2. 6.1. 

RemoveCCV 

Section  2. 1.2. 6.3. 

PlaceBombs 

Section  2. 1.2. 1.1. 

FireVolley 

Section  2.1. 2.4.2. 

Repair  Request 

Section  2. 1.6. 1.3. 

ResupplyOffer 

Section  2. 1.1. 2.4. 

EmplaceRequest 

Section  2. 1.1. 2.2. 

BreachRequest 

Section  2. 1.1. 2.3. 

Table  2.1-3:  ProcessMessage  Information, 


2.1. 1.2.2  EmplaceRequest 

EmpIaceRequest  processes  a  message,  msg,  containing  an  emplacement  request  from  the 
CEW.  The  f^unction  call  is  EmplaceRequest(msg).  Table  2.1-4  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

msg 

pointer  to  MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

vertices 

pointer  to  LongPt 

/simnet/common/include/glob 

al/lonqpt.h 

vertex  count 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

wide  bdry 

Section  2.21.1.31.1. 

Mines  Emplace  Minefield 

Section  2.1. 8.3.7. 

Marker  Emplace  Minefield 

Section  2. 1.8. 2.1. 

1  Called  By  1 

Function 

Where  Described 

ProcessMessage 

Section  2. 1.1. 2.1. 

Table  2.1-4:  EmplaceRequest  Information. 

2. 1.1. 2. 3  BreachRequest 

BreachRequest  processes  a  message,  msg,  containing  a  breach  request  from  the  CEW. 
The  function  call  is  BreachRequest(msg).  Table  2.1-5  describes  the  parameters  used  and 
functions  called  using  this  function. 
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Parameters 

Parameter 

Where  Typedef  Declared 

msg 

pointer  to  MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

start 

pointer  to  LongPt 

/simnetysimnet/common/inclu 

de/global/longpt.h 

end 

pointer  to  LongPt 

/simnet/simnet/common/inclu 

de/global/longpt.h 

length 

double 

Standard  C  type. 

bounds 

array  4  of  LongR 

/simnet/simnet/common/inclu 

de/alobal/longpt.h 

dx 

double 

Standard  C  type. 

width 


left  xO 


left  x1 


riaht  xO 


riaht  x1 


left  vO 


left  v1 


riaht  vO 


riaht  v1 


xO 


x1 


0 


'1 


marker  azimuth 


double 


double 


double 


double 


double 


double 


double 


double 


double 


double 


double 


double 


double 


double 


double 


double 


double 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Function 


radians  to  simnet  angle 


Marker  Add  Line 


simnet  angle  to  radians 


Mines  Emplace  Breach 


Calls 


Where  Described 


|in!S!!!!lll 

\jmm 


Section  2. 1.8. 2.2. 


Section  2.1. 8.3.9. 


Function 


ProcessMessage 


Called  B 


Where  Described 


Section  2. 1.1. 2.1. 


Table  2.1-5:  BreachRequest  Information. 


2. 1.1. 2. 4  ResuppIyOffer 

ResupplyOffer  is  used  to  allow  the  Admin  process  to  send  resupply  offers  out  to  the 
network.  Since  the  network  channel  does  not  robustly  allow  multiple  concurrent  accesses 
to  the  network,  this  function  provides  a  mutual  exclusion  mechanism  for  preventing  other 
network  access  by  another  entity,  rmg  is  a  resupplyOffer  PDU  which  is  dispatched  onto 
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the  network.  The  function  call  is  ResupplyOffer(msg).  Table  2.1-6  describes  the 
parameter  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

msg 

pointer  to  MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

Calls 

Function 

Where  Described 

AssocSendDataoram 

Section  2.20.1.2.1. 

AssocError 

Section  2.20.1.10.1. 

Function 


ProcessMessaqe 


Called  B 


Where  Described 


Section  2. 1.1. 2.1. 


Table  2.1-6:  ResupplyOffer  Information. 

2.1. 1.2.5  PDU_Dispatch_NOP 

As  packets  are  received  from  the  network,  an  index  into  a  function  table  is  computed  using 
two  pieces  of  information:  1 )  the  type  of  packet,  either  a  DATAGRAM  or  a 
TRANSACTION,  and  2)  the  protocol  group  for  the  packet,  either  "simulation",  "data 
collection",  or  "management"  protocol.  The  function  which  processes  the  received  packet 
is  then  called  via  the  computed  index  in  the  function  table.  PDU_Dispatch_NOP  is  a 
"placeholder"  routine  which  performs  No  Operation  (NOP).  Initially,  the  entire  dispatch 
table  is  set  to  NOP's.  Then,  Init_PDU_Dispatch()  fills  in  entries  in  the  dispatch  table  for 
packets  which  the  MCC  is  interested  in.  PDU_Dispatch_NOP()  is  called  in  order  to  ignore 
(or  not  process)  a  received  packet  which  does  not  have  an  initialized  group/tj^e  pair.  The 
function  call  is  PDU_Dispatch_NOP(PDU,  PDU_Len,  Group,  Protocol,  Originator, 
Trans_ID,  Respondent).  Table  2.1-7  describes  the  parameters  used  by  this  function. 


Parameters 


Parameter 


PDIJ 


PDJ  Len 


Group 


Protocol 


Originator 


TransJD 


Respondent 


MulticastGroupID 


AssociationUserProtocol 


SimulationAddress 


T  ransactionidentif  ier 


SimulationAddress 


Where  Tvoedef  Declared 


Standard  C  type. 


Standard  C  type. 


/simnet/common/include/prot 
ocol/p  assoc. h 


/simnet/common/include/prot 
ocol/p  assoc. h 


/simnet/common/include/prot 
oco  I/address. h 


/simnet/common/include/prot 

ocol/address.h 


/simnet/common/include/prot 

ocol/address.h 


Return  Values 


Return  Value 


0 


Type 


int 


Meaning 


Always  returned. 


Table  2.1-7:  PDU  Dispatch  NOP  Information. 
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2. 1.1. 2. 6  Init_PDU_Dispatch 

Init_PDU_Dispatch  initializes  the  PDU  dispatch  table.  The  function  call  is 
Init_PDU_Dispatch().  Table  2.1-8  describes  the  internal  variables  used  by  this  function. 


Variable 


ProcessDataColDataaram 


ProcessMqmtDataaram 


ProcessSimT  ransaction 


ProcessDataColTransaction 


ProcessMarntT  ransaction 


Internal  Variables 


e 


unsianed  int 


unsianed  int 


extern  int 


extern  int 


extern  int 


extern  int 


extern  int 


extern  int 


Function 


Init  MCC  Processin 


Called  B 


Where  Described 


Section  2. 1.1. 2.8. 


Where  Tvbedef  Declared 


Standard  C  tvpe. 


Standard  C  type. 


Section  2. 1.6. 2.9. 


Section  2.1 .6.2.2. 


Section  2. 1.6.2. 4. 


Section  2. 1.6. 2. 6. 


Section  2. 1.6. 2.3. 


Section  2. 1.6. 2.5. 


Table  2.1-8:  Init  PDU  Dispatch  Information, 

2.1. 1.2.7  Check_Net 

Check_Net  is  basically  the  main  loop  for  the  MCC.  It  runs  until  the  MCC  terminates  or  is 
restarted,  reading  packets  off  of  the  network.  The  variable  assoc_status  is  returned  by  the 
call  to  AssocReceivePDU().  assoc_status  is  defined  as  follows: 

- 1  =  an  Association  layer  error  has  occurred 
0  =  a  packet  of  interest  was  received 

1  -  a  packet  not  of  interest  was  received 

2  =  no  packets  are  waiting  to  be  received. 


The  function  call  is  Check_Net().  Table  2.1-9  describes  the  internal  variables  used,  errors 
returned,  and  functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

assoc  status 

int 

Standard  C  type. 

activity 

register  pointer  to  Activity 

/simnet/mcc/Mother/mother.c 

last  assoc  tick 

Standard  C  type. 

PDU 

pointer  to  char 

Standard  C  type. 

PDU  Len 

long 

Standard  C  type. 

Group 

MulticastGroupID 

/simnet/common/include/prot 
ocol/p  assoc. h 

Protocol 

AssociationUserProtocol 

/simnet/common/include/prot 
ocol/p  assoc. h 

Primitive 

long 

Standard  C  type. 

Originator 

SimulationAddress 

/simnet/common/include'prot 

ocol/address.h 

Trans_ID 

Transact  ionidentifier 

/simnet/commoninclude/prot 

ocol/address.h 

Respondent 

SimulationAddress 

/simnet/common'include-prot 

ocol/address.h 
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Error  Name 


MCC  ASSOC  RECEIVE 


MCC  ASSOC  TICK 


Errors 


Reason  for  Error 


Association  layer  error  has  occurred 


Association  layer  error  has  occurred 


Function 


net  current  time 


AssocReceivePDU 


AssocError 


AlarmsEnabled 


AssocTickAssocLayer 


Calls 


Where  Described 


Section  2.20.2.8.3. 


Section  2.20.1.6.1. 


Section  2.20.1.10.1. 


Section  2.21.2.4.4. 


Section  2.20.1.8.1. 


Function 


Called  B 


Where  Described 


Section  2. 1.1. 2.8. 


Table  2.1-9:  Check  Net  Information. 


2.1. 1.2.8  InitMCCProcessing 

Init_MCC_Processing  initializes  the  MCC.  process  specifies  the  process  name  of  the 
calling  process.  This  is  used  by  InitializeProcessO  to  look  up  information  in  the  process 
table,  param  Jile  is  a  pointer  to  the  text  string  of  the  parameter  file  which  should  be  used 
for  MCC  initialization.  The  function  call  is  Init_MCC_Processing(process,  param_file). 
Table  2.1-10  describes  the  parameters  used  and  functions  called  using  this  function. 
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Function 


YUMMInit 


YUMMCleanu 


Init  PDU  Dispatch 


InitializeProcess 


ProcessParameters 


AlarmsEnabled 


InitProcessTable 


InitCCV 


InitIndirectFire 


InitVehicleTables 


AssocGetSimAddress 


net  init  time 


ResetLocks 


Lock 


Spawn  Process 


AssocSubscribe 


MCC  SvstemError 


Act  List  Init 


Check  Net 


Where 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Calls 


Described 


2.21.2.10.1. 


2.21.2.10.5. 


2.1. 1.2.6. 


2.21.1.19.1. 


2.1.1.3.19. 


2.21.2.4.4. 


2.1. 1.4.1. 


2.1 .2.3.1. 


2.1. 2.4.1. 


2. 1.1. 5.2. 


2.20.1.9.1. 


2.20.2.8.4. 


2.21.2.6.2. 


2.21.2.6.3. 


2.21.1.26.1. 


2.20.1.1.1. 


2.21.1.11.3. 


2.I.4.I.3. 


2.1 .1.2.7. 


Called  B 


Function 

Where  Described 

main 

Section  2. 1.1. 2.9. 

Table  2.1-10;  Init_MCC_Processing  Information. 

2. 1.1. 2. 9  main 

main  is  the  entry  point  to  the  Mother  process.  The  function  call  is  main(argc,  argv).  Table 
2.1-1 1  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


c 


Parameters 


e  Where  Tvpedef  Declared 


int  Standard  C  type. 


inter  to  pointer  to  char  Standard  C  type. 


Calls 


Function  Where  Described 


set  a  ethernet  two  packets  Section  2.21.1.22.2. 


Init  MCC  Processin 


ResetMCC 


MCC  SystemError 


Section  2. 1.1. 2.8. 


Section  2. 1.5. 1.1. 


Section  2.21.1.11.3. 


Table  2.1-11:  main  Information. 


2. 1.1. 3  param.c 

/simnet/mcc/Moth  er/p;iram  .c 

param.c  contains  functions  which  process  the  MCC  parameter  file.  The  name  of  the 
parameter  file  is  supplied  as  an  argument  to  the  command  that  starts  up  the  MCC, 
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Ini t_MCC_processing,  described  in  Section  2.1. 1.2. 8.  Table  2.1-12  describes  the 
variables  used  by  param.c. 


1  Variables  I 

Variable 

Where  Tvpedef  Declared 

kwdTable 

array  of  struct  kwd 

/simnet/mcc/Mother/param.c 

conTable 

struct  kwd 

/simnet/mcc/Mother/param.c 

Table  2.1-12:  param.c  Variable  Information. 


2. 1.1. 3.1  Battalion 

Battalion  reads  in  the  Battalion  parameter.  The  battalion  entry  describes  a  battalion  number 
for  this  MCC  system.  Since  there  may  be  multiple  MCC  systems  participating  in  a  single 
exercise,  each  MCC  system  must  have  its  own  unique  battalion  number.  The  function  call 
is  Battalion(F).  Table  2. 1-13  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

F 

pointer  to  FILE 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

“Missing  or  incorrect 
parameter  value” 

pointer  to  char 

Unsuccessful. 

NULL 

pointer  to  char 

Successful. 

Table  2.1-13:  Battalion  Information. 


2. 1.1. 3. 2  Bridge 

Bridge  reads  in  the  Bridge  parameter.  The  bridge  entry  tells  the  MCC  host  where  to  find 
the  Bridge  linking  it  to  the  AppleTalk  network.  It  has  one  parameter,  device,  which  gives 
the  name  of  the  RS-232  port  to  which  the  Bridge  is  connected.  The  function  call  is 
Bridge(F).  Table  2.1-14  describes  the  parameters  used  by  this  function. 


1  Parameters 

Parameter 

Type 

Where  Typedef  Declared 

F 

pointer  to  FILE 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

“Missing  or  incorrect 
parameter  value” 

pointer  to  char 

Unsuccessful. 

NULL 

pointer  to  char 

Successful. 

Table  2.1-14:  Bridge  Information. 
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2. 1.1. 3. 3  Console 

Console  reads  in  the  Console  parameter.  The  console  entry  specifies  the  name  the  MCC 
host  should  use  when  trying  to  locate  a  console  Macintosh  with  the  AppleTalk  Name 
Binding  Protocol.  The  configuration  file  should  contain  a  console  entry  for  each  console  of 
the  MCC  system.  The  console  entry  has  two  parameters:  type  and  name.  Type  is  the  type 
of  the  MCC  console:  see  (SIMNET  Control  Console),  place  (Vehicle  Placement  console), 
al  (Admin/Log  Console),  maint  (Maintenance  Console),  fse  (Fire  Support  Console),  cas 
(Close  Air  Support)  or  cew  (Combat  Engineering  Workstation).  Name  is  the  name  of  that 
console’s  Macintosh.  Because  the  console  name  may  be  more  than  one  word,  it  must  be 
enclosed  in  quotation  marks.  The  function  call  is  Console(F).  Table  2.1-15  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

F 

pointer  to  FILE 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

kp 

pointer  to  struct  kwd 

/simnet/mcc/Mother/param.c 

str 

array  pi  20  of  char 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

"Missing  or  incorrect 
parameter  value" 

pointer  to  char 

Unsuccessful. 

“Unknown  console  type" 

pointer  to  char 

Unsuccessful. 

“Console  name  too  long" 

pointer  to  char 

Unsuccessful. 

“Too  many  placement 
consoles" 

pointer  to  char 

Unsuccessful. 

NULL 

pointer  to  char 

Successful. 

Calls 

Function 

Where  Described 

ScanString 

Section  2.1.1.3.20. 

Table  2.1-15:  Console  Information. 

2. 1.1. 3. 3  Ex_Log 

Ex_Lx)g  reads  in  the  Ex_Log  parameter.  The  Ex_Log  entry  describes  a  file  into  which  the 
MCC  system  records,  for  each  exercise:  the  time  it  entered  the  exercise,  the  duration  of  its 
involvement  in  the  exercise,  and  statistics  that  summarize  its  involvement  in  the  exercise. 
This  entry  has  one  parameter,  file,  which  is  the  name  of  the  file  to  be  used  by  the  MCC 
system.  The  function  call  is  Ex_Log(F).  Table  2.1-16  describes  the  parameters  used  and 
errors  returned  by  this  function. 
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Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

str 

array  1 20  of  char 

Standard  C  type. 

Return  Value 


Missing  or  incorrect 
arameter  value" 


NULL 


Return  Values 


Type _ 


pointer  to  char 


pointer  to  char 


Meaning 


Unsuccessful. 


Successful. 


Errors 


Error  Name  Reason  for  Error 


MCC  OPEN  FILE  ERROR  Could  not  open  the  file. 


Table  2.1-16:  Ex_Log  Information. 

2. 1.1. 3. 4  Exercise 

Exercise  reads  in  the  Exercise  parameter.  The  exercise  entry  specifies  the  exercise  identifier 
of  the  exercise  in  which  this  MCC  system  will  participate.  The  function  call  is  Exercise(F). 
Table  2.1-17  describes  the  parameters  used  by  this  function. 


Parameters 


oinferto  FILE 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Standard  C  type. 


Where  Tvoedef  Declared 


Standard  C  type. 


NULL 


Type 

Meaning 

pointer  to  char 

Unsuccessful. 

pointer  to  char 

Successful. 

Table  2.1-17:  Exercise  Information. 


2. 1.1. 3. 5  Password 

Password  reads  in  the  Password  parameter.  The  password  entry  indicates  the  word  that 
the  BattleMaster  must  enter  at  the  SCC  Console  in  order  to  perform  restricted  duties  such  as 
reconstituting  vehicles,  setting  up  gunnery  targets,  ending  an  exercise,  etc.  This  entry  has 
one  parameter,  secret  password,  which  is  the  password  to  be  typed  in  when  BattleMaster 
functions  are  desired.  The  function  call  is  Password(F).  Table  2.1-18  describes  the 
parameters  used  by  this  function. 
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Variable 


str 


Internal  Variables 


e 


arrav  1 20  of  char 


MCC  CSCI 


Where  Tvoedef  Declared 


Standard  C  tvoe. 


Return  Value 


Ion  ■■ 


NULL 


Type 

Meaning 

pointer  to  char 

Unsuccessful. 

pointer  to  char 

Unsuccessful. 

pointer  to  char 

Successful. 

Table  2.1-18:  Password  Information. 


2.1. 1.3.6  Smoke 

Smoke  reads  in  the  Smoke  parameter.  The  smoke  entry  describes  a  file  which  has 
parameters  to  model  the  white  phosphorous  smoke  clouds.  This  entry  has  one  parameter, 
file,  which  is  the  name  of  the  file  to  be  used  by  the  MCC  system.  The  function  call  is 
Smoke(F).  Table  2.1-19  describes  the  parameters  used  by  this  function. 


Parameters 


Parameter 


ointerto  FILE 


Where  Tvoedef  Declared 


Standard  C  type. 


Variable 


str 


Internal  Variables 


e 


arrav  1 20  of  char 


Where  Tvoedef  Declared 


Standard  C  tvoe. 


Return  Values 

Return  Value 

Type 

Meaning 

“Missing  or  incorrect 
parameter  value" 

pointer  to  char 

Unsuccessful. 

“Smoke  parameters  filename 
too  Iona" 

pointer  to  char 

Unsuccessful. 

NULL 

pointer  to  char 

Successful. 

Table  2.1-19:  Smoke  Information. 

2.1. 1.3.7  Terrain 

Terrain  reads  in  the  Terrain  parameter.  The  terrain  entry  describes  a  terrain  database  stored 
on  the  MCC  host’s  disk  drive.  The  configuration  file  should  contain  one  terrain  entry  for 
each  terrain  database  available  to  the  MCC  system.  The  terrain  entry  has  one  parameter, 
terrain  database,  which  is  the  name  of  a  terrain  database  on  the  host’s  filesystem.  The 
function  call  is  Terrain(F).  Table  2.1-20  describes  the  parameters  used  by  this  function. 
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1  internal  Variables  1 

Variable 

Where  Typedef  Declared 

str 

array  120  of  char 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

‘Too  many  terrain  databases" 

pointer  to  char 

Unsuccessful. 

“Missing  or  incorrect 
parameter  value" 

pointer  to  char 

Unsuccessful. 

“Terrain  filename  too  long" 

pointer  to  char 

Unsuccessful. 

NULL 

pointer  to  char 

Successful. 

Table  2.1-20:  Terrain  Information. 

2. 1.1. 3. 8  VehLog 

Veh_Log  reads  in  the  Veh_Log  parameter.  The  Veh_Log  entry  describes  a  file  into  which 
the  MCC  system  records,  for  each  exercise,  information  about  the  use  of  each  simulated 
vehicle  deployed  by  the  MCC  system.  Also  recorded  is  a  unique  exercise  key  which  may 
be  used  to  cross-reference  data  with  that  in  the  log  file.  This  entry  has  one  parameter,  file, 
which  is  the  name  of  the  file  to  be  used  by  the  MCC  system.  The  routine  should  return 
NULL  if  sucessful  and  "Missing  or  incorrect  parameter  value"  when  the  number  of 
parameters  in  the  Veh_Log  entry  is  not  correct.  Veh_log  expects  a  single  parameter,  F, 
which  is  the  name  of  the  file  to  use  as  the  vehicle  log  file,  llie  function  call  is  Veh_Log(F). 
Table  2.1-21  describes  the  parameters  used  and  errors  returned  by  this  function. 


Parameter 


Variable 


str 


Return  Value 


“Missing  or  incorrect 
parameter  value" 


NULL 


Error  Name 


Parameters 


Type 


pointer  to  FILE 


Where  Typedef  Declared 


Standard  C  type. 


Internal  Variables 


Type 


array  1 20  of  char 


Where  Typedef  Declared 


Standard  C  type. 


Return  Values 


Type 


pointer  to  char 


pointer  to  char 


Meaning 


The  number  ot  parameters  in 
the  Veh_Log  entry  is  not 
correct. 


Successful, 


Errors 


MCC  OPEN  FILE  ERROR  |  Could  not  open  the  file. 


Reason  for  Error 


Table  2.1-21:  Veh  Log  Information. 


2. 1.1. 3. 9  Vehicle 


Vehicle  reads  in  the  Vehicle  parameter.  The  vehicle  entry  describes  a  vehicle  simulator  to 
the  MCC  system.  The  configuration  file  should  contain  a  vehicle  entry  for  each  simulator 
that  is  available  for  use  in  the  simulation  exercise.  The  parameters  of  the  vehicle  entry  are. 
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in  order:  address,  trailer,  trailer  element  and  type.  Address  is  the  simulator’s  address  on 
the  SIMNET  local  area  network.  Trailer  and  trailer  element  specify  the  physical  location  of 
the  simulator,  they  are  a  number  and  a  letter,  respectively.  Type  is  the  t>^  of  vehicle  that 
the  simulator  simulates.  The  function  call  is  Vehicle(F).  Table  2.1-22  describes  the 
parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

F 

pointer  to  FILE 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Sim 

pointer  to  SimulatorStatus 

/simnet/mcc/include/vehjabi 

e.h 

str 

array  1 20  of  char 

Standard  C  type. 

i 

inf 

Standard  C  type. 

i 

int 

Standard  C  type. 

k 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

“Too  many  vehicle  simulators” 

pointer  to  char 

Unsuccessful. 

“Missing  or  incorrect 
parameter  value" 

pointer  to  char 

Unsuccessful. 

NULL 

pointer  to  char 

Successful. 

Table  2.1-22;  Vehicle  Information. 


2.1.1.3.10  VList 


VList  reads  in  the  vlist  parameter.  The  vlist  entry  specifies  the  size  of  the  vehicle  list.  This 
is  the  maximum  number  of  vehicles  which  can  be  in  an  exercise  that  the  MCC  is  a  part  of. 
The  size  of  the  vehicle  status  list  is  the  same.  The  function  call  is  VList(F).  Table  2.1-23 
describes  the  parameters  used  by  this  function. 


Parameters 


Parameter 


Type. 


Where  Typedef  Declared 


pointer  to  FILE 


Standard  C  type. 


Internat  Variables 


Variable 


lyfie. 


Where  Typedef  Declared 


int 


Standard Cj^£e^ 


Return  Values 


Return  Value 


Type 


Meaning 


“Missing  or  incorrect 
parameter  value" 


pointer  to  char 


Unsuccessful. 


NULL 


pointer  to  char 


Successful. 


Table  2.1-23:  VList  Information. 
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2.1.1.3.11  VehHashTableSize 

VehHashTableSize  reads  in  the  vehhashsize  parameter.  The  vehhashsize  entry  specifies  the 
size  of  the  internal  hash-table  used  to  index  vehicles  in  the  vehicle  list,  vehhashsize  should 
always  be  a  prime  number.  The  function  call  is  VehHashTableSize(F).  Table  2.1-24 
describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

F 

pointer  to  FILE 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

“Missing  or  incorrect 
parameter  value” 

pointer  to  char 

Unsuccessful. 

NULL 

pointer  to  char 

Successful. 

Table  2.1-24:  VehHashTableSize  Information. 

2.1.1.3.12  StatusHashSize 

StatusHashSize  reads  in  the  statushashsize  parameter.  The  statushashsize  entry  specifies 
the  size  of  the  internal  hash-table  used  to  index  previously  saved  vehicle  status  packets, 
statushashsize  should  always  be  a  prime  number.  The  function  call  is  StatusHashSize(F). 
Table  2. 1  -25  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

F 

pointer  to  FILE 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

“Missing  or  incorrect 
parameter  value” 

pointer  to  char 

Unsuccessful. 

NULL 

pointer  to  char 

Successful. 

Table  2.1-25:  StatusHashSize  Information. 


2.1.1.3.13  VehicIeMarkingR 

VehicleMarkingR  reads  in  the  vehiclemarking  parameter.  The  vehiclemarking  parameter 
specifies  a  fixed  string  which  should  be  prepended  to  the  text  field  of  thr  vehicleMarking 
field  in  Vehicle  Appearance  PDUs  generated  by  MCC  ccvs.  The  function  call  is 
VehicleMarkingR(F).  Table  2. 1-26  describes  the  parameters  used  by  this  function. 
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Table  2.1-26:  VehicleMarkingR  Information. 
2.1.1.3.14  CurBattleScheme 

CurBattleScheme  reads  in  the  batdescheme  parameter.  The  function  call  is 
CurBattleScheme(F).  Table  2.1-27  describes  the  parameters  used  by  this  function. 


Parameter 


F 


Variable 


Parameters 


e 


ointerlo  FILE 


Internal  Variables 


e 


Where  Tvpedef  Declared 


Standard  C  tvoe. 


Where  Tvpedef  Declared 


Standard  C  type. 


Return  Values 

Return  Value 

Type 

Meaning 

"Missing  or  incorrect 
parameter  value” 

pointer  to  char 

Unsuccessful. 

NULL 

pointer  to  char 

Successful. 

Table  2.1-27:  CurBattleScheme  Information. 
2.1.1.3.15  DefineBattleScheme 

DefineBattleScheme  reads  in  the  battleScheme  matrices.  The  function  call  is 
DefineBattleScheme(F).  Table  2.1-28  describes  the  parameters  used  by  this  function. 


Parameters 


Parameter 


F 


inter  to  FILE 


Where  Tvpedef  Declared 


Standard  C  type. 


Variable 


scheme 


Internal  Variables 


e 


ointer  to  BattleSchemes 


array  8  of  char 


Where  Tvpedef  Declared 


Standard  C  type. 


Standard  C  type. 


/simnet/mcc/libmcc/quise.h 


Standard  C  type. 
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1  Return  Values  I 

Return  Value 

Type 

Meaning 

“Missing  or  incorrect  scheme 
number” 

pointer  to  char 

Unsuccessful. 

“Incorrect  scheme  number" 

pointer  to  char 

Unsuccessful. 

“Missing  country  param” 

pointer  to  char 

Unsuccessful. 

“Invalid  country  param” 

pointer  to  char 

Unsuccessful. 

NULL 

pointer  to  char 

Successful. 

Table  2.1>28:  DefineBattleScheme  Information. 


2.1.1.3.16  MineScanInterval 

MineScanInterval  reads  in  the  minescan  parameter.  The  minescasn  entry  specifies  how 
often  the  MCC  checks  for  vehicles  passing  through  minefields  that  the  MCC  is  simulating. 
The  value  is  in  milliseconds  and  the  MCC  typically  checks  1/3  of  the  vehicles  in  an  exercise 
during  each  scan.  The  function  call  is  MineScanlnterval(F).  Table  2.1-29  describes  the 
parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

F 

pointer  to  FILE 

Standard  C  type. 

internal  Variables 

Variable 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

“Missing  or  incorrect  scan 
interval  number" 

pointer  to  char 

Unsuccessful. 

NULL 

pointer  to  char 

Successful. 

Table  2.1-29;  MineScanInterval  Information. 


2.1.1.3.17  MarkerSpacing 

MarkerSpacing  reads  in  the  makerspacing  parameter.  The  markerspacing  en^  specifies 
how  far  apart  each  flag  which  is  placed  around  the  borders  of  an  emplac^  minefield  or 
breached  lane  should  be  from  the  previous  one.  The  function  call  is  MarkerSpacing(F). 
Table  2.1-30  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

F 

pointer  to  FILE 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

“Missing  or  incorrect  marking 
spacing  number” 

pointer  to  char 

Unsuccessful. 

NULL 

pointer  to  char 

Successful. 

Table  2.1-30:  MarkerSpacing  Information. 


2.1.1.3.18  Markerlnterval 

Markerinterval  reads  in  the  markerbroadcast  parameter.  The  markerbroadcast  entry 
specifies  how  frequently,  in  milliseconds,  the  minefield  marker  flags  are  broadcast  to  the 
network.  The  function  call  is  Markerlnterval(F).  Table  2.1-31  describes  the  parameters 
used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

F 

pointer  to  FILE 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

“Missing  or  incorrect  marker 
broadcast  interval  number" 

pointer  to  char 

Unsuccessful. 

NULL 

pointer  to  char 

Successful. 

Table  2.1-31:  Markerlnterval  Information. 


2.1.1.3.19  ProcessParameters 


ProcessParameters  parses  the  MCC  parameter  file.  ProcessParameters  reports  errors  in  the 
condition  that: 

—  The  parameter  file  cannot  be  opened 

—  The  routine  called  to  deal  with  the  parameter  returns  a  non-null  text  string  (the 
error  text) 

—  A  keyword  is  seen  which  does  not  match  any  keywords  in  the  keyword  table 
—  Extraneous  information  is  recognized  on  a  line  of  data 


The  function  call  is  ProcessParameters(filename).  Table  2.1-32  describes  the  parameters 
used  and  errors  returned  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

filename 

pointer  to  char 

Standard  C  type. 
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Variable 


kwdStrin 


errStrin 


str 


Internal  Variables 


inter  to  FILE 


inter  to  struct  kwd 


array  50  of  char 


inter  to  char 


array  1 20  of  char 


Where  Tvoedef  Declared 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


/simnet/mcc/Mother/param.c 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Errors 


Error  Name  Reason  for  Error 


MCC  OPEN  FILE  ERROR  The  parameter  cannot  be  opened. 


MCC  PARAMETER  ERROR  1  Error  in  a  parameter. 


Function 


Init  MCC  Processin 


Called  B 


Where  Described 


Section  2. 1.1. 2.8. 


Table  2.1-32:  ProcessParameters  Information. 

2.1.1.3.20  ScanString 

ScanString  reads  a  string  enclosed  in  quotes.  The  function  call  is  ScanString(f,  cp).  Table 
2.1-33  describes  the  parameters  used  by  this  function. 


Parameter 


Parameters 


e 


ointerto  FILE 


reqister  pointer  to  char 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Variable 


Internal  Variables 


e 


reqister  int 


Where  Tvpedef  Declared 


Standard  C  type. 


Return  Value 


0 


Return  Values 


Type 


Meaning 


String  does  not  have  leading 
quote. 


Successful. 


Called  B 


Function 

Where  Described 

Console 

Section  2. 1.1. 3.3. 

Table  2.1-33:  ScanString  Information. 

2.1. 1.4  process. c 

/simnet/mcc/Mother/process.c 

process. c  contains  a  function  that  initializes  a  table  of  the  MCC  process.  Table  2. 1  -34 
describes  the  variables  used  by  process.c 
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1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

process 

array  of  struct  process 

/simnet/mcc/Mother/process.c 

Table  2.1-34:  process.c  Variable  Information. 


2. 1.1. 4.1  InitProcessTable 

InitProcessTable  initializes  the  process  table  in  shared  memory.  Note  that  before  changing 
processes,  we  change  into  a  subdirectory  to  verify  that  the  filename  to  run  is  in  the  original 
directory.  The  function  call  is  InitProcessTable().  Table  2.1-35  describes  the  internal 
variable  used  by  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

reqister  short 

Standard  C  type. 

Called  By 

Function 

Where  Described 

Init  MCC  Processinq 

Section  2. 1.1. 2.8. 

Table  2.1-35;  InitProcessTable  Information. 


2.1. 1.5  vehicle. c 

/simnet/mcc/Mother/vehicle.c 

vehicle. c  contains  functions  that  manage  the  vehicle  lists  and  tables. 

2. 1.1. 5.1  AllocShMem 

AllocShMem  is  used  to  allocate  shared  memory'  for  vehicle  and  status  lists.  Size  is  the  size 
in  bytes  of  the  area  to  allocate  and  Param  is  a  pointer  to  the  MCC  parameter  block. 
Information  in  the  parameter  block  is  used  to  create  the  shared  memory  segment.  The 
function  call  is  AllocShMem(Size,  Param).  Table  2.1-36  describes  the  parameters  used 
and  functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Size 

int 

Standard  C  type. 

Param 

MCCParameters 

/simnet/mcc/include/MCC_par 

s.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

memloc 

pointer  to  char 

Standard  C  type. 

shmid 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

memloc 

pointer  to  char 

Pointer  to  the  allocated 
memory  area 
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1  Calls  1 

Function 

Where  Described 

AttachSharedMem 

Section  2.21.2.7.1. 

TaLle  2.1-36:  AllocShMem  Information. 


2.1. 1.5.2  InitVehicleTables 


InitVehicleTables  initializes  the  tables  of  CCVs,  simulators  and  vehicles.  The  function  call 
is  InitVehicleTablesQ.  Table  2.1-37  describes  the  internal  variables  used  and  functions 
called  using  this  function. 


1  internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

ccv 

register  pointer  to  CCVStatus 

/simnet/mcc/include/veh_tabl 

e.h 

Calls 

Function 

Where  Described 

FQueue  Create 

Section  2.21.1.13.3. 

Called  By 

Function 

Where  Described 

Init  MCC  Processing 

Section  2. 1.1. 2.8. 

Table  2.1-37:  InitVehicleTables  Information. 


2. 1.1. 5. 3  VehicIelDToSim 

VehiclelDToSim  maps  a  vehicle  ID,  vehiclelD,  to  a  pointer  to  the  SimulatorStatus  for  the 
simulator  owning  the  ID.  It  returns  a  pointer  to  the  SimulatorStatus,  or  0  if  the  vehicle  ID 
does  not  belong  to  one  of  our  simulators.  The  function  call  is  VehiclelDToSim(vehiclelD). 
Table  2.1-38  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

vehiclelD 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

_  Internal  Variables  _ 

Variable  [Type  I  Where  Typedet  Declared 

veh  register  pointer  to  /simnet/mcc/include/vehjabi 


VehiclelDSfatus  I  e.h 


Return  Values 

Return  Value 

Type 

Meaning 

0 

pointer  to  SimulatorStatus 

Vehicle  does  not  belong  to 
one  of  our  simulators. 

(&vehicles->sim[veh->index]) 

pointer  to  SimulatorStatus 

Pointer  to  SimulatorStatus  tor 
simulator  that  owns  vehicle. 
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1  Calls  1 

Function 

Where  Described 

FQueue  Retrieve 

Section  2.21.1.13.7. 

Called  By 

Function 

Where  Described 

CountRoundsFired 

Section  2.1.6.2.10. 

VTimeout  Appearance  Timo 
ut 

Section  2.1. 7.2.1. 

Table  2.1-38:  VehIclelDToSim  Information. 


2. 1.1. 5. 4  GetVehicIeLocation 

GetVehicleLocation  obtains  a  vehicle’s  location.  vehiclelD  is  used  to  specify  the  vehicle; 
location  and  vehicleGuises  are  returned  information  about  the  vehicle.  The  lookup  is 
performed  using  either  the  internal  ccv  table  for  the  local  MCC  vehicles  or  by  checking  the 
vehicle  list  for  appearance  PDU  if  the  vehicle  is  a  remote  vehicle.  The  function  call  is 
GetVehicleLocation(vehicleID,  vehicleGuises,  location).  Table  2.1-39  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

vehiclelD 

pointer  to  VehiclelD 

/simnet/common/include/prol 

ocol/basic.h 

vehicleGuises 

pointer  to  VehicleGuises 

/simnet/common/include/prot 

ocol/basic.h 

location 

array  of  float 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

veh 

pointer  to  VehiclelDStatus 

/simnet/mcc/include/veh_tabl 

e.h 

ccv 

pointer  to  CCVStatus 

/simnet/mcc/include/veh_tabl 

e.h 

VA 

VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

Calls 

Function 

Where  Described 

FQueue  Retrieve 

Section  2.21.1.13.7. 

net  current  iime 

Section  2.20.2.8.3. 

Called  By 

Function 

Where  Described 

GuideBomber 

Section  2. 1.2. 1.2. 

NearbyVehicle 

Section  2. 1.2.5. 2. 

NearestCombatVehicle 

Section  2.1.2  5.3. 

Table  2.1-39:  GetVehicleLocation  Information. 
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2. 1.1. 5. 5  IsGroundVehicIe 


IsGroundVehicIe  determines  whether  a  vehicle  type,  given  by  vehicleGuise,  represents  a 
ground  vehicle.  The  function  call  is  IsGroundVehicle(vehicleGuise).  Table  2.1-40 
describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

vehicleGuise 

ObjectType 

/simnet/common/include/prot 

ocol/basic.h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

int 

Not  a  ground  vehicle. 

1 

int 

Ground  vehicle. 

I  Called  By  I 

Function 

Where  Described 

GuideBomber 

Section  2. 1.2. 1.2. 

NearbvVehicle 

Section  2.1. 2.5.2. 

NearestCombatVehicle 

Section  2. 1.2. 5.3. 

Table  2.1-40:  IsGroundVehicIe  Information. 


2. 1.1. 5. 6  IsCombatVehicle 


IsCombatVehicIe  determines  whether  a  vehicle  type,  given  by  guise,  represents  a  combat 
vehicle.  Only  ground  vehicles  are  checked.  The  function  call  is  IsCombatVehicle(gi’ise). 
Table  2.1-41  describes  the  parameters  used  by  this  function. 


1  Parameters 

Parameter 

Type 

Where  Typedef  Declared 

guise 

ObjectType 

/simnet/common/include/prot 

ocol/basic.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

obi  function 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

Not  a  combat  vehicle. 

1 

int 

Combat  vehicle. 

Called  By 

Function 

Where  Described 

NearestCombatVehicle 

Section  2. 1.2. 5.3. 

Table  2.1-41:  IsCombatVehicle  Information. 
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2.1.2  Modeling  Computer-Controlled  Vehicles  (CCVs) 

This  software  initializes  the  CCVs  according  to  input  from  the  Macintosh  consoles.  It 
issues  appearance  packets  for  them  periodically  when  they  are  visible  and  issues  a 
deactivate  packet  when  they  should  be  made  invisible.  It  notices  when  one  of  the  CCVs 
has  been  hit  by  something  on  the  batde  field  and  assesses  damages  accordingly.  It  also 
keeps  track  of  when  indirect  fire  is  due  to  be  dropped  and  issues  the  appropriate  PDUs  for 
mortars,  howitzers  and  close  air  support  bombs.  In  addition,  it  keeps  a  CCV  Population 
Density  Map  which  maps  the  locations  of  the  CCVs  into  500  meter  by  500  meter  squares  to 
enable  faster  processing  when  it  needs  to  search  for  CCVs  in  a  given  area.  This 
functionality  is  realized  by  the  following  CSUs: 

cas.c 

ccv_change.c 

ccv_model.c 

fire.c 

placement.c 

popden.c 


2. 1.2.1  cas.c 

/simnet/mcc/Mother/cas.c 

cas.c  contains  functions  for  processing  requests  to  drop  bombs  from  the  CAS  process. 
Table  2.1-42  shows  the  variable  used  by  cas.c. 


1  Variables  I 

Variable 

Where  Typedef  Declared 

nextBombEventID 

unsigned  short 

Standard  C  type. 

Table  2.1-42:  cas.c  Variable  Information. 


2. 1.2. 1.1  PlaceBombs 

PlaceBombs  lays  a  sortie’s  worth  of  bombs.  This  function  passes  the  location  and  heading 
to  GuideBomber,  which  changes  them  within  casTargetRange  and  casHeadingRange,  if 
necessary,  to  make  the  sortie  more  effective.  It  then  computes  the  (x,y)  for  each  bomb, 
using  location,  heading  and  bomb  scatter  parameters  from  MCC_data.h,  puts  these  in  a 
VolleyDescriptor  along  with  the  delay  between  detonations  and  a  unique  event  ID  for  each 
detonation.  Finally,  PlaceIndirectFire  (Section  2.1. 2.4.4.)  is  called  to  generate  Indirect 
Fire  PDUs  for  the  detonations.  The  function  call  is  PlaceBombs(location,  heading).  Table 
2.1-43  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

location 

array  of  float 

Standard  C  type. 

heading 


float 


Standard  C  tvoe. 
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Variable 


det 


Internal  Variables 


e 


reg  ster  pointer  to  struct 
detonation 


Where  Tvpedef  Declared 


register  short 

Standard  C  type. 

float 

Standard  C  type. 

float 

Standard  C  type. 

float 

Standard  C  type. 

float 

Standard  C  type. 

VollevDescriptor 

/simnet/mcc/Mother/mother.h 

Function 


GuideBomber 


PlaceIndirectFire 


Calls 


Where  Described 


Section  2. 1.2. 1.2. 


Section  2.1 .2.4.4. 


Function 


ProcessMessaae 


Called  B 


Where  Described 


Section  2. 1.1. 2.1. 


Table  2.1-43:  PlaceBombs  Information. 

2. 1.2. 1.2  GuideBomber 

GuideBomber  adjusts  the  location  and  heading  of  a  CAS  sortie’s  bombing.  targetLocation 
is  the  location  to  which  the  sortie  was  dispatched  and  heading  points  to  the  run-in  heading 
requested  (in  degrees  clockwise  from  north).  The  function  call  is 
GuideBomber(targetLocation,  heading).  Table  2.1-44  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameters 


Parameter 


tarqetLocation 


headin 


array  of  float 


ointerto  float 


Where  Tyoedef  Declared 


Standard  C  type. 


Standard  C  type. 
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Internal  Variables 

Variable 

Where  Tvpedef  Declared 

ccv 

register  pointer  to  CCVStatus 

/simnet/mcc/include/veh_tabl 

e.h 

vehLocation 


dx 


oldHeadin 


newHeadin 


ccvList 


vehicle  ID 


vlist  Dtr 


VA 


guises 


VehiclelDSfatus 


reaister  unsioned  short 


array  2  of  float 


float 


float 


float 


float 


array  numberCCVS  of 
unsioned  short 


pointer  to  VehiclelD 


ointer  to  FQueue  t 


pointer  to 

Vehicle  AppearanceVariant 


VehicleGuises 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


Standard 


C  type. 


C  type. 


C  type. 


C  type. 


C  type. 


C  type. 


C  type. 


/simnet/common/include/prot 

ocol/basic.h 


/simnel/mcc/libmcc/fqueue.h 


/simnet/common/include/prot 
ocol/p  sim.h 


/simnet/common/include/prot 

ocol/basic.h 


Calls 

Function 

Where  Described 

NearbyCCVs 

Section  2. 1.2.2. 4. 

ConsiderVehicle 

Section  2. 1.2.1. 3. 

FQueue  _Scan 

Section  2.21.2.13.6. 

FQueue  Retrieve 

Section  2.21.2.13.7. 

GetVehicleLocation 

Section  2. 1.1 .5.4. 

IsGroundVehicle 

Section  2. 1.1. 5.5. 

deg_to_rad 

Macro  defined  in 

/simnet/common/include/Qlobal/sim  macros. h. 

Function 


PlaceBombs 


Called  B 


Where  Described 


Section  2. 1.2. 1.1. 


Table  2.1-44:  GuideBomber  Information. 


2. 1.2. 1.3  ConsiderVehicIe 


ConsiderVehicle  evaluates  a  vehicle  on  the  ground  as  a  target  for  a  CAS  attack.  A  list  of 
vehicles  within  range  of  the  target  location  is  accumulated  in  global  data  structures. 
targetLocation  is  the  x,  y  and  z  coordinates  of  the  intended  target  area.  vehiclelD  is  the  ID 
of  a  vehicle  which  should  be  considered  a  target.  vehLocation  is  th  x,  y  and  z  coordinates 
corresponding  with  the  ID  of  the  vehicle  that  is  being  considered  a  target.  This  location  is 
compared  with  targetLocation  to  see  if  it  is  within  the  tolerances  used  by  the  CAS 
simulation.  The  function  call  is  ConsiderVehicle(targetLocation,  vehiclelD,  vehLocation). 
Table  2.1-45  describes  the  parameters  used  and  errors  returned  using  this  function. 
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1  Parameters  I 

Parameter 

Where  Typedef  Declared 

taraetLocation 

array  of  float 

Standard  C  type. 

vehiclelD 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

vehLocation 

array  of  float 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

dx 

float 

Standard  C  type. 

dy 

float 

Standard  C  type. 

distance 

float 

Standard  C  type. 

1  Errors  1 

Error  Name 

Reason  for  Error 

MCC  TOO  MANY  TARGET 

S 

Too  many  targets  (more  than  maxCASTargets)  for  the  CAS  pilot 
to  handle. 

1  Called  By  1 

Function 

Where  Described 

GuideBomber 

Section  2. 1.2. 1.2. 

Table  2.1-45:  ConsiderVehicIe  Information. 


2. 1.2.2  popden.c 

/simnet/mcc/Mother/popden.c 

popden.c  contains  the  routines  for  the  population  density  map  of  computer  controlled 
vehicles.  The  terrain  is  divided  up  into  buckets  500  meters  square.  Each  bucket  contains  a 
pointer  (in  actuality,  an  array  index)  into  a  doubly  linked  list  of  CCVs  in  that  bucket.  Each 
CCV  in  the  list  also  contains  the  coordinate  of  the  bucket  to  which  it  belongs.  The  actual 
storage  for  the  list  is  an  array  of  PopDenEntry  elements  which  is  indexable  by  the  number 
of  the  CCV  whose  links  are  contained  therein.  Table  2.1-46  shows  the  variables  used  by 
popden.c. 


I  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

numberOfBuckets 

int 

Standard  C  type. 

pdmBucketsX 

short 

Standard  C  type. 

pdmBucketsY 

short 

Standard  C  type. 

pdmindex 

pointer  to  short 

Standard  C  type. 

pointer  to  PopDenMapEntry 

/simnet/mcc/Mother/popden.c 

Table  2.1-46;  popden.c  Variable  Information. 

2. 1.2. 2.1  InitPopDenMap 

InitPopDenMap  initializes  the  Population  DensiiyMap  for  the  particular  size  of  terrain 
chosen  for  the  exercise.  The  function  call  is  InitPopDenMapO.  Table  2.1-47  describes  the 
internal  variable  used  and  errors  returned  using  this  function. 
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1  Internal  Variables  I 

Variable 

Ejpnmmmmmm 

Where  Typedef  Declared 

i 

reqister  int 

Standard  C  type. 

1  Errors  1 

Error  Name 

Reason  tor  Error 

MCC  NO  MEMORY 

The  MCC  has  mn  out  of  memory. 

1  Called  Bv  1 

Function 

Where  Described 

ProcessMessaae 

Section  2. 1.1. 2.1. 

Table  2.1-47:  InitPopDenMap  Information. 


2. 1.2. 2. 2  PDMInsert 

PDMInsert  inserts  an  entry  into  the  Population  Density  Map  for  a  CCV  that  has  been  placed 
on  the  terrain,  vehicle  is  the  number  of  the  CCV  being  placed  and  location  is  the  vehicle’s 
new  location  on  the  terrain.  The  function  call  is  PDMInsert(vehicle,  location).  Table  2.1- 
48  describes  the  parameters  used,  errors  returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

vehicle 

unsigned  short 

Standard  C  type. 

location 

array  ot  float 

Standard  C  type. 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

bucket 

register  int 

Standard  C  type. 

entry 

register  pointer  to 
PopDenMapEntry 

/s  imnet/mcc/M  ot  h  e  r/popde  n .  c 

1  Errors  1 

Error  Name 

Reason  for  Error 

MCCJNCONSISTENCY 

A  bucket  in  the  population  density  map  lies  outside  the 
memory  area. 

1  Calls  1 

Function 

Where  Described 

PDMDelete 

Section  2. 1.2. 2.3. 

1  Called  By  1 

Function 

Where  Described 

PlaceCCV 

Section  2.1. 2.6.1. 

Table  2.1-48:  PDMInsert  Information. 


2. 1.2. 2. 3  PDMDelete 

PDMDelete  removes  a  vehicle’s  entry,  vehicle,  from  the  Population  Density  Map.  The 
function  call  is  PDMDelete(vehicIe).  Table  2.1-49  describes  the  parameters  used  by  this 
function. 
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Parameters 

Parameter 

Type 

Where  Typedef  Declared 

vehicle 

unsigned  short 

Standard  C  tvoe. 

Variable _ Type _ Where  Typedef  Declared 

bucket _ _ register  int _ Standard  C  type. _ 

entry  register  pointer  to  /simnet/mcc/Mother/popden.c 

PopDenMapEntry 


_ Called  By _ 

Function  [where  Described 

PDMInsert _ Section  2.1.2.2.2. _ 

BroadcastCCVBatch  Section  2.I.2.3.2. 

Table  2.1-49:  PDMDelete  Information. 


2. 1.2. 2. 4  NearbyCCVs 

NearbyCCVs  prepares  a  list  of  the  CCVs  near  a  specified  location,  location  is  the 
coordinates  of  the  center  of  the  area  of  interest,  range  is  the  range  about  the  location  of 
interest  and  list  is  the  vector  to  be  filled  with  CCV  numbers,  list  must  be  large  enough  to 
accomodate  the  “worst  case”  of  numberCCVs  entries.  The  function  call  is 
NearbyCCVs(location,  range,  list).  Table  2.1-50  describes  the  parameters  used  by  this 
function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

location 

array  of  float 

Standard  C  type. 

range 

int 

Standard  C  type. 

list 

array  of  unsigned  short 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

start  X 

int 

Standard  C  type. 

start  Y 

int 

Standard  C  type. 

end  X 

int 

Standard  C  type. 

end  Y 

int 

Standard  C  type. 

bX 

int 

Standard  C  type. 

bY 

int 

Standard  C  type. 

bucket 

register  short 

Standard  C  type. 

vehicle 

register  short 

Standard  C  type. 

vp 

register  pointer  to  unsigned 
short 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

(vp  -  list) 

int 

List  of  CCVs  in  area. 
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Called  B 


Function 

Where  Described 

GuideBomber 

Section  2. 1.2. 1.2. 

IndirectFireDamaae 

Section  2.1 .2.4.6. 

NearbyVehicle 

Section  2. 1.2.5. 2. 

Table  2.1-50:  NearbyCCVs  Information. 

2. 1.2.3  ccv_modeI.c 

/simnet/mcc/Mother/ccv_model.c 

ccv_model.c  contains  routines  for  modelling  the  behavior  of  CCVs.  The  MCC  must 
broadcast  VehicleAppearance  PDUs  periodically  for  all  visible  CCVs.  For  CCVs  other 
than  gunnery  targets,  it  broadcasts  PDUs  in  batches  -  a  few  batches  a  second  -  so  that  it 
cycles  through  all  CCVs  in  five  seconds.  PDUs  are  broadcast  for  gunnery  targets  with 
turrets  every  second  so  that  they  will  appear  to  be  smoothly  scanning  their  guns.  When  a 
CCV  changes  appearance,  a  PDU  is  always  broadcast  for  it  at  the  next  batch.  Table  2.1-51 
shows  the  variables  used  by  ccv_model.c. 


Variable 


howitzerMu2zle 


mortarMuzzle 


batchSize 


lastBatchTime 


nextCCV 


vaBuf 


daBuf 


networklnterface 


Internal  Variables 


e 


array  3  of  float 


array  3  of  float 


short 


short 


SimulationPDU 


SimulationPDU 


SimulationPDU 


DataCollectionPDU 


extern  int 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


/simnet/common/include/prot 
ocol/p  sim.h 


/simnet/common/include/prot 
ocol/p  sim.h 


/simnet/common/include/prot 
ocol/p  sim.h 


/simnet/common/include/prot 
ocol/p  data.h 


Standard  C  type. 


Table  2.1-51:  ccv  model.c  Variable  Information. 

2. 1.2. 3.1  InitCCV 

InitCCV  initializes  this  CCV  modelling  package.  The  function  call  is  InitCCV().  Table 
2.1-52  describes  the  internal  variables  used  by  this  function. 


Variable 


batchesPerCycle 


lElT? 


Internal  Variables 


e 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Function 


Called  B 


Where  Described 


Section  2. 1.1. 2.8. 


Table  2.1-52:  InitCCV  Information. 
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2. 1.2. 3. 2  BroadcastCCVBatch 

BroadcastCCVBatch  broadcasts  a  batch  of  PDUs  for  some  CCVs.  The  function  call  is 
BroadcastCCVBatch().  Table  2.1-53  describes  the  internal  variables  used  and  functions 
called  using  this  function. 


Variable 


vehicle 


ccv 


newSecond 


msg 


Internal  Variables 


e 


reoister  unsiqned  short 


lElT! 


Where  Tvoedef  Declared 


Standard  C  type. 


register  pointer  to  CCVStatus  /simnet/mcc/include/vehjabi 

e.h 


unsianed  short 


unsiqned  short 


MCCMessage  Buffer 


Standard  C  type. 


Standard  C  type. 


/simnet/mcc/include/MCCJpc 

.h 


Return  Value 


ccvBatch  Period 


Return  Values 


Type 


int 


Meaning 


Delay  time  before  calling 
function  again. 
ccvBatch  Period  is  a  constant 
defined  in 

/simnet/mcc/include/MCC_tim 

ers.h. 


Function 


SendMCCMsq2 


AssocSendDataqram 


PRO_DATA_STATUS_CHAN 
GE  SIZE 


PDMDelete 


DeactivafeVehicle 


BroadcastAppearance 


Calls 


Where  Described 


Macro  defined  in  /simnet/mcc/include/MCC  i 


Section  2.20.1.2.1. 


Macro  defined  in  /simnet/common/include/protocol/p_si2e.h 


Section  2. 1.2. 2.3. 


Section  2.1.4.2.11. 


Section  2. 1.2. 3.3. 


Table  2.1-53:  BroadcastCCVBatch  Information. 

2. 1.2. 3. 3  BroadcastAppearance 

BroadcastAppearance  broadcasts  a  Vehicle  Appearance  PDU  for  a  CCV,  vehicle.  The 
function  call  is  BroadcastAppearance(vehicle).  Table  2.1-54  describes  the  parameters  used 
and  functions  called  using  this  function. 


Parameters 


Parameter 


vehicle 


lfI73 


unsiqned  short 


Where  Tvpedef  Declared 


Standard  C  type. 


Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

ccv 

register  pointer  to  CCVStatus 

/simnet/mcc/include/vehjabi 

e.h 
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Calls 


Function  Where  Described 


AssocSendDataaram  Section  2.20.1.2.1. 


PRO_SIM_APPEARANCE_SI  Macro  defined  in  /simnet/common/include/protocol/p_size.h 


Called  B 


Function 

Where  Described 

BroadcastCCVBatch 

Section  2.1. 2.3.2. 

Table  2.1-54:  BroadcastAppearance  Information. 

2. 1.2. 3. 4  BroadcastDeactivate 

BroadcastDeactivate  broadcasts  a  Deactivate  PDU  for  either  a  CCV  or  a  simulator, 
determined  by  vehiclelD.  The  function  call  is  BroadcastDeactivate(vehiclelD). 
Table  2.1-55  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


vehiclelD 


IDTS 


pointer  to  VehiclelD 


Where  Tvoedef  Declared 


/simnet/common/include/prot 

ocol/basic.h 


Function 


AssocSendTransact 


Calls 


Where  Described 


Section  2.20.1.4.1. 


Table  2.1-55:  BroadcastDeactivate  Information. 

2. 1.2. 3. 5  FireShell 

FireShell  fires  a  shell  from  a  mortar  or  howitzer,  vehicle  is  the  ccv  number  of  the  vehicle 
firing  the  mortar/howitzer  shell,  projectile  is  the  SIMNET  projectile  being  fired,  detonator 
is  the  SIMNET  detonator  on  the  projectile  being  fired.  eventID  is  a  pointer  to  a  SIMNET 
eventID  to  use  in  the  fire  and  impact  packet  sent  on  the  network.  Events  on  the  network  are 
linked  via  the  eventID.  The  function  call  is  FireShell(vehicle,  projectile,  detonator, 
eventID).  Table  2.1-56  describes  the  parameters  used  and  functions  called  using  this 
function. 
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1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

ccv 

register  pointer  to  CCVStatus 

/simnet/mcc/include/veh_tabl 

e.h 

i 

register  short 

Standard  C  type. 

muzzle 

pointer  to  float 

Standard  C  type. 

temp 

array  3  of  float 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

Unsuccessful. 

1 

int 

Successful.  The  firing  vehicle 
is  healthy  and  visible. 

1  Calls  1 

Function 

Where  Described 

fvec  mat  mul 

Section  2.6.2.22.1  in  the  Vehicles  CSCI. 

AssocSendDataaram 

Section  2.20.1.2.1. 

PRO  SIM  FIRE  SIZE 

Macro  defined  in  /simnet/common/include/protocol.'p  size.h 

1  Called  By  1 

Function 

Where  Described 

CheckVolleyTable 

Section  2.1. 2.4.3. 

Table  2.1-56:  FireShell  Information. 


2. 1.2.4  fire.c 

/simnet/mcc/Mother/fire.c 


fire.c  contains  routines  which  support  the  simulation  of  indirect  fire.  Table  2. 1-57  shows 
the  variables  used  by  fire.c. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

networkinterface 

extern  int 

Standard  C  type. 

indBuf 

SimulationPDU 

/simnet/common/include/prot 
ocol/p  sim.h 

volleyTable 

pointer  to  VolleyDescriptor 

/simnet/mc/Mother/mother.h 

Table  2.1-57;  fire.c  Variable  Information. 


2. 1.2. 4.1  InitIndirectFire 

InitIndirectFire  initializes  the  indirect  fire  package.  The  function  call  is  lnitIndirectFire(). 
Table  2.1-58  describes  the  internal  variable  used  and  errors  returned  usine  this  function. 


Variable 


Internal  Variables 


reaister  short 


Where  Typedef  Declared 


Standard  C  type. 
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1  Errors  I 

Error  Name 

Reason  for  Error 

MCC_NO_M  EMORY 

Couldn't  allocate  the  table  of  descriptions  of  volleys  in 
progress. 

Called  Bv 

Function 

Where  Described 

Init  MCC  Processing 

Section  2. 1.1. 2.8. 

Table  2.1-58:  InitIndirectFire  Information. 

2. 1.2. 4. 2  FireVolley 

FireVolley  queues  volleys  of  indirect  fire  for  firing  at  some  later  time.  This  call  is  invoked 
due  to  an  IPC  message  from  the  FSE  process.  It  uses  the  "volley"  structure  of  the 
MCCMessageBuffer  structure  defined  in  mcc/include/MCC_ipc.h.  msg  specifies  the 
quantity  and  type  of  fire  which  has  been  called  for.  The  function  call  is  FireVolley(msg). 
Table  2.1-59  describes  the  parameter  used  and  errors  returned  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

msg 

pointer  to  MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

volley 

register  pointer  to 
VolleyDescriptor 

/simnet/mcc/Mother/mother.h 

i 

register  short 

Standard  C  type. 

1  Errors  1 

Error  Name 

Reason  for  Error 

MCC_NO_VOLLEY 

Maximum  number  of  valleys  already  queued;  there  is  no  space 
for  more  volleys  at  the  current  time. 

1  Called  By  1 

Function 

Where  Described 

ProcessMessage 

Section  2. 1.1. 2.1. 

Table  2.1-59:  FireVolley  Information. 

2. 1.2. 4. 3  CheckVolleyTable 

CheckVolleyTable  cycles  through  the  table  of  active  volleys,  looking  for  something  that 
needs  to  be  done,  such  as  firing  a  shell  by  broadcasting  a  Fire  PDU  or  reporting  the  impact 
of  the  shells  with  an  Indirect  Fire  PDU.  The  function  call  is  CheckVolleyTable().  Table 
2.1-60  describes  the  internal  variables  used  and  functions  called  using  this  function. 
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Internal  Variables 

Variable 

Where  Typedef  Declared 

volley 

register  pointer  to 
VollevDescriptor 

/simnet/mcc/Mother/mother.c 

register  short _ Standard  C  type. 

register  short  Standard  C  type. 


Return  Values 

Return  Value 

Type 

Meaning 

volleyTablePeriod 

int 

Delay  before  calling  the 
procedure  again. 
volleyTablePeriod  is  a 
constant  defined  in 
/simnet/mcc/include/MCC_tim 
ers.h. 

Calls 

Function 

Where  Described 

FireShell 

Section  2.1. 2.3.5. 

PlacelndirectFire 

Section  2.1  2.4.4. 

Table  2. 1*60:  CheckVolleyTable  Information. 


2. 1.2. 4. 4  PlacelndirectFire 


PlacelndirectFire  generates  indirect  fire  detonations  on  the  terrain,  volley  describes  the 
type,  quantity  and  location  of  detonations  which  are  to  be  placed  on  the  terrain.  The 
function  call  is  PlaceIndirectFire( volley).  Table  2.1-61  describes  the  parameters  used, 
errors  returned  and  functions  called  using  this  function. 


Parameter 


volley 


Parameters 


register  pointer  to 
VollevDescriptor 


Where  Tvnedet  Declared 


/simnet/mcc/Mother/mother.c 


Variable 


msgDet 


pduDet 


revDela 


msgDetIdx 


duDetIdx 


delays 


location 


Internal  Variables 


e 


register  pointer  to  struct 
detonation 


Where  Tvoedef  Declared 


register  pointer  to 
IndirectFireDetonation 

/simnet/common/include/prot 
ocol/p  sim.h 

int 

Standard  C  type. 

int 

Standard  C  type. 

short 

Standard  C  type. 

short 

Standard  C  type. 

array 

maxIndirectFireDetonations  of 
unsigned  char 

Standard  C  type. 

TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 
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1  Errors  I 

Error  Name 

Reason  for  Error 

MCC  BAD  TERRAIN 

Terrain  location  specified  in  the  volley  descriptor  is  not  valid. 

Calls 

Function 

Where  Described 

SendIndirectFirePDU 

Section  2. 1.2.4 .5. 

tdb  qet  z 

Section  2.21.7.16.2. 

tdb  error 

Section  2.21.7.17.1. 

Called  Bv 

Function 

Where  Described 

CheckVollevTable 

Section  2. 1.2.4. 3. 

PlaceBombs 

Section  2. 1.2. 1.1. 

Table  2.1-61:  PlaceIndirectFire  Information. 

2. 1.2. 4. 5  SendIndirectFirePDU 

SendIndirectFirePDU  completes  and  sends  an  Indirect  Fire  PDU,  and  assesses  any  damage 
caused  to  CCVs  by  the  detonation.  At  the  time  of  the  call,  the  PDU  is  partially  assembled 
in  the  buffer  indBuf.  quantity  is  the  number  of  detonations  to  send  on  the  net.  delays  is 
the  delay,  in  seconds,  between  subsequent  detonations.  The  function  call  is 
SendIndirectFirePDU (quantity,  delays).  Table  2.1-62  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters 

Parameter 

Where  Typedef  Declared 

quantity 

int 

Standard  C  type. 

delays 

array  of  unsiqned  char 

Standard  C  type. 

internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

reqister  int 

Standard  C  type.  • 

1  Calls  1 

Function 

Where  Described 

AssocSendDataqram 

Section  2.20.1.2.1. 

PRO  SIM  IND  FIRE  SIZE 

Macro  defined  in  /simnet/common/include/protocol/p  size.h 

AssocError 

Section  2.20.1.10.1. 

IndirectFireDamaqe 

Section  2. 1.2. 4.6. 

1  Called  Bv  1 

Function 

Where  Described 

PlaceIndirectFire 

Section  2. 1.2. 4.4. 

Table  2.1-62:  SendIndirectFirePDU  Information. 
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2. 1.2. 4. 6  IndirectFireDamage 

IndirectFireDamage  assesses  the  damage  done  to  our  CCVs  by  indirect  fire,  pdu  is  an 
IndirectFire Variant  PDU  which  contains  information  about  a  series  of  indirect  (artillery  or 
mortar)  fir  detonations  which  occur  at  some  location  on  the  terrain.  The  routine  checks  the 
packet  to  see  if  any  of  the  detonations  are  close  enough  to  local  CCVs  in  order  to  damage 
them.  The  function  call  is  IndirectFireDamage(pdu).  Table  2.1-63  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

pdu 

pointer  to  IndirectFireVariant 

/simnet/common/include/proi 

ocol/p_sim,h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

det 

register  pointer  to 
IndirectFireDetonation 

/simnet/common/include/prot 
ocol/p  sim.h 

ccv 

register  pointer  to  CCVStatus 

/simnet/mcc/include/vehjabi 

e.h 

i 

reaister  int 

Standard  C  type. 

detidx 

unsigned  short 

Standard  C  type. 

accumDelay 

unsigned  short 

Standard  C  type. 

numberNearbv 

unsigned  short 

Standard  C  type. 

ccvList 

array  numberCCVs  of 
unsigned  short 

Standard  C  type. 

roll 

int 

Standard  C  type. 

delta 

array  3  of  float 

Standard  C  type. 

distance 

float 

Standard  C  type. 

floatLoc 

array  3  of  float 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

NearbyCCVs 

Section  2. 1.2. 2.4. 

AttackCCV 

Section  2. 1.2. 6.4. 

1  Called  Bv  1 

Function 

Where  Described 

SendIndirectFirePDU 

Section  2.1. 2.4.5. 

ProcessSimDataqram 

Section  2. 1.6. 2.9. 

Table  2.1-63;  IndirectFireDamage  Information. 

2. 1.2. 5  placement. c 

/simnet/mcc/Mother/placement.c 

placement.c  contains  routines  for  the  “intelligent”  placement  of  CCVs  and  simulators. 

2. 1.2. 5.1  FindAnOpenSpot 

FindAnOpenSpot  finds  a  suitable  location  for  the  placement  of  a  vehicle.  vehiclelD  is  the 
identifier  of  the  vehicle  to  be  placed,  location  is  the  point  on  the  terrain  about  which  to 
search  and  yaw  is  the  azimuth  of  the  vehicle  to  be  placed.  The  function  returns  1  if  a  spot 
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is  found,  0  if  not.  location  is  changed  to  the  spot  found  for  the  vehicle  and  rotation  is  the 
orientation  of  the  vehicle  if  it  is  placed  at  that  spot.  A  suitable  spot  for  placement  is  one 
with  no  other  vehicles  or  terrain  objects  within  the  distance  vehicleRaduis  (6  meters),  and 
with  a  navigable  slope  and  soil  type.  An  error  is  signalled  in  the  case  where  a  terrain 
lookup  is  perfomed  to  check  for  obstacles  or  ground  height  above  sea  level,  and  the  terrain 
database  code  (libtdb)  returns  an  error  or  undefined  information.  The  function  call  is 
FindAnC)penSpot(vehicleID,  location,  yaw,  rotation).  Table  2.1-64  describes  the 
parameters  us^,  errors  returned  and  functions  called  using  this  function. 


Parameter 


vehiclelD 


location 


aw 


rotation 


Parameters 


e 


pointer  to  VehiclelD 


reoister  array  of  float 


double 


3  by  3  matrix  of  double 


Where  Tvpedef  Declared 


/simnet/common/include/prot 

ocol/basic.h 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

objectCount 

int 

Standard  C  type. 

soilType 

int 

Standard  C  type. 

tryCount 


direction 


terrainBounds 


stepSize 


testLocatiion 


tdbLocation 


Return  Value 


Error  Name 


MCC  BAD  TERRAIN 


short 


short 


short 


short 


2  by  2  matrix  of  float 


float 


array  2  of  float 


TDB_POINT 


8  by  2  matrix  of  char 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


/simnet/common/libsrc/libtdb/t 

db.h 


Standard  C  type. 


Return  Values 


Type 

Meaning 

int 

Unsuccessful. 

int 

Successful 

Errors 


Reason  for  Error 


Error  from  libtdb  calls. 


Calls 

Function 

Where  Described 

NearbyVehicle 

Section  2.1. 2.5.2. 

Act  List  Loc  Exists 

Section  2. 1.4. 1.6. 

tdb  object  count 

Section  2.21.7.26.2. 

tdb  error 

Section  2.21.7.17.1. 

Mines  Point  In  Minefield 

Section  2.1.8.3.13. 

tdb  qet  hull  to  world 

Section  2.21.7.20.1. 

tdb  oet  z 

Section  2.21.7.16.2. 

Section  2. 1.3. 1.1. 
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1  Called  Bv  1 

Function 

Where  Described 

PlaceCCV 

Section  2. 1.2. 6.1. 

ActiyateVehicle 

Section  2.1.4.2  8. 

Table  2.1-64:  FindAnOpenSpot  Information. 


2. 1.2. 5. 2  NearbyVehicIe 

Nearby  Vehicle  tests  for  vehicles  near  a  specified  location,  determined  by  location  and 
range,  excluding  from  consideration  a  particular  vehicle  (usually  the  one  being  placed), 
specified  by  vehiclelD.  The  function  call  is  NearbyVehicle(location,  vehiclelD,  range). 
Table  2.1-65  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


location 


vehiclelD 


ranae 


ccvList 


vehicleGuises 


Parameters 


e 


reqister  array  of  float 


pointer  to  vehiclelD 


Where  Tvoedef  Declared 


Standard  C  type. 


/simnet/common/include/prot 

ocol/basic.h 


Standard  C  type. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

ccy 

register  pointer  to  CCVStatus 

/simnet/mcc/include/veh_tabl 

e.h 

yeh 

register  pointer  to 
VehiclelDStatus 

/simnet/mcc/include/vehjabi 

e.h 

VA 

register  pointer  to 
VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

vlist  ptr 

pointer  to  FQueue  t 

/simnet/mcc/libmcc/fqueue.h 

dx 

float 

Standard  C  type. 

float 


array  2  of  float 


unsioned  short 


array  numberCCVs  of 
unsioned  short 


VehicleGuises 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


/simnet/common/include/prot 

ocol/basic.h 


Return  Value 


Return  Values 


Type 


int 


int 


Meaning 


No  yehicle  within  range. 


Vehicle  within  range. 


Function 


NearbyCCVs 


FQueue  Scan 


GetVehicleLocation 


IsGroundVehicle 


Calls 


Where  Described 


Section  2. 1.2. 2.4. 


Section  2.21.1.13.6. 


Section  2. 1.1. 5.4. 


Section  2. 1.1. 5.5. 
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1  Called  Bv  1 

Function 

Where  Described 

FindAnOpenSpot 

Section  2.1. 2.5.1. 

Table  2.1-65:  NearbyVehicIe  Information. 


2. 1.2. 5. 3  NearestCombatVehicIe 

NearestCombatVehicle  finds  the  ground  combat  vehicle  nearest  to  a  specified  location. 
location  is  the  place  on  the  terrain  to  search  around  and  range  determines  how  far  out  to 
search  for  a  combat  vehicle.  The  function  returns  1  if  a  vehicle  is  found  and  0  otherwise. 
location  gets  the  location  of  the  combat  vehicle.  The  function  call  is 
NearestCombatVehicle(location,  range).  Table  2.1-66  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

location 

array  of  float 

Standard  C  type. 

ranqe 

float 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

veh 

register  pointer  to 
VehiclelDStatus 

/simnet/mcc/include/vehjabi 

e.h 

i 

unsigned  short 

Standard  C  type. 

V  ehicleFound 

unsigned  short 

Standard  C  type. 

vehicleGuises 

VehicleGuises 

/simnet/common/include/prot 

ocol/basic.h 

dx 

float 

Standard  C  type. 

dy 

float 

Standard  C  type. 

vehLocation 

array  2  of  float 

Standard  C  type. 

distance 

float 

Standard  C  type. 

closestDistance 

float 

Standard  C  type. 

closestLocation 

array  2  of  float 

Standard  C  type. 

vlist  ptr 

pointer  to  FQueue.  t 

/simnet/mcc/libmcc/fqueue.h 

Return  Values 

Return  Value 

Type 

Meaning 

vehicleFound 

int 

1  if  found,  0  if  not. 

Calls 

Function 

Where  Described 

FQueue  Scan 

Section  2.21.1.13.6. 

GetVehicleLocation 

Section  2. 1.1. 5.4. 

IsGroundVehicle 

Section  2. 1.1. 5. 5. 

IsCombatVehicle 

Section  2. 1.1. 5. 6. 

Called  By 

Function 

Where  Described 

PlaceCCV 

Section  2. 1.2. 6.1. 

Table  2.1-66;  NearestCombatVehicle  Information, 
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2. 1.2. 6  ccv_change.c 

/simnet/nicc/Mother/ccv_change.c 

ccv_change.c  contains  routines  for  making  CCVs  visible  and  invisible,  and  for  damaging 
them. 

2. 1.2. 6.1  PlaceCCV 

PlaceCCV  places  a  CCV  on  the  terrain,  making  it  visible.  requestID  is  a  code  supplied  by 
YUMM,  used  in  returning  a  response  to  the  message  that  requested  the  placement  of  the 
CCV.  msg  is  the  showCCV  message  requesting  the  placement  of  the  CCV.  It  may  not  be 
possible  to  place  the  CCV  at  the  location  requested.  There  may  be  another  vehicle  that  is 
too  close,  or  the  terrain  may  be  too  steep  or  impassable.  Also,  HEMMTs  and  Repair 
vehicles  have  an  “affinity”  for  Combat  vehicles.  The  actual  location  will  be  determined  by 
PlaceCCV,  and  the  location  field  of  the  mesage  will  be  changed  to  this  new  location.  An 
entry  for  the  CCV  is  put  into  the  vehicle  table.  If  the  CCV  is  on  the  terrain,  an  entry  is 
made  in  the  Population  Density  Map,  and  the  CCV’s  state  is  set  to  ccvHealthy.  Otherv\’ise, 
its  state  is  ccvDisappearing.  This  routine  signals  errors  in  the  cases  where  preallocated 
memory  has  run  out  for  either  the  vehicle  status  list  or  the  vehicle  ID  table.  This  error 
indicates  that  the  MCC  is  attempting  to  simulate  too  many  vehicles.  The  function  call  is 
PlaceCCV(requestID,  msg).  Table  2.1-67  describes  the  parameters  used,  errors  returned 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

requestID 

long 

Standard  C  type. 

msg 

register  pointer  to 
MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

CCV 

pointer  to  CCVStatus 

/simnet/mcc/include/veh_tabl 

e.h 

i 

register  short 

Standard  C  type. 

i 

register  short 

Standard  C  type. 

rotation 

3  by  3  matrix  of  double 

Standard  C  type. 

tmp_veh 

VehiclelDStatus 

/simnet/mcc/include/veh_tabl 

e.h 

status 

int 

Standard  C  type. 

Errors 

Error  Name 

Reason  for  Error 

MCC  NO  VEHICLE  ID 

No  more  vehicles  IDs  are  available. 

MCC  VST  OUE  NOMEM 

The  vehicle  status  list  is  out  of  space. 

1  1 
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1  Calls  1 

Function 

Where  Described 

FQueue  Insert 

Section  2.21.1.13.4. 

VehiclelsGunneryTarget 

Section  2. 1.2. 6.2. 

NearestCombatVehicle 

Section  2.1. 2.5.3. 

FindAnOpenSpot 

Section  2.1. 2.5.1. 

mil_to_rad 

Macro  defined  in 

/simnet/common/include/global/sim  macros. h. 

DeactivateVehicle 

Section  2.1.4.2.11. 

PDMInsert 

Section  2. 1.2.2. 2. 

SendRsp 

Section  2.21.2.10.8. 

Called  By 

Function 

Where  Described 

ProcessMessage 

Section  2.1. 1.2.1. 

Table  2.1-67:  PlaceCCV  Information. 

2. 1.2. 6. 2  VehiclelsGunneryTarget 

VehiclelsGunneryTarget  returns  TRUE  if  a  vehicle  has  no  capabilities,  capabilites  specifies 
whether  the  vehicle  has  the  ability  to  recover,  resupply  or  repair  vehicles  on  the  battlefield. 
If  a  CCV  has  any  of  these  capabilities  then  it  is  NOT  a  gunnery  target.  If  it  has  none  of 
these  capabilities,  then  the  vehicle  is  an  MCC  gunnery  target.  The  function  call  is 
VehiclelsGunneryTarget(capabilities).  Table  2.1-68  describes  the  parameters  used  by  this 
function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Deciared 

capabilities 

pointer  to  VehicleCapabilites 

/simnet/common/include/prot 

ocol/basic.h 

Return  Values 

Return  Value 

Type 

Meaning 

FALSE 

int 

Vehicle  is  not  a  gunnery 
target. 

TRUE 

int 

Vehicle  is  a  gunnery  target. 

Called  By 

Function 

Where  Described 

PlaceCCV 

Section  2. 1.2, 6.1. 

Table  2.1-68:  VehiclelsGunneryTarget  Information. 

2. 1.2. 6. 3  RemoveCCV 

RemoveCCV  takes  a  CCV  off  of  the  terrain,  vehicle  refers  to  the  vehicle  to  be  removed. 
The  function  call  is  RemoveCCV(vehicle).  Table  2.1-69  describes  the  parameter  used  by 
this  function. 
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1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

vehicle 

unsigned  short 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

ccv 

register  pointer  to  CCVStatus 

/simnet'mcc/include/vehjabl 

e.h 

Called  Bv 

Function 

Where  Described 

ProcessMessaqe 

Section  2. 1.1. 2.1. 

Table  2.1-69:  RemoveCCV  Information. 


2. 1.2. 6. 4  AttackCCV 

AttackCCV  notes  an  attack  on  a  CCV  occuring  now  or  in  the  immediate  future.  cc\’  is  the 
attacked  CCV,  delay  is  the  time  until  the  attack  in  ticks,  agentID  is  the  vehicle  ID  of  the 
attacker,  eventID  is  the  event  identifier  and  cause  is  the  reason  for  the  demise  of  the  CCV. 
The  function  call  is  AttackCCV (ccv,  delay,  agentID,  eventID,  cause).  Table  2. 1-70 
describes  the  parameters  used  by  this  function. 


Table  2.1-70:  AttackCCV  Information. 


2.1.3  Positioning  Vehicles 

This  second  level  CSC  provides  a  routine  to  determine  if  a  location  is  suitable  to  position  a 
vehicle  based  on  the  soil  type  and  pitch  of  the  terrain.  It  conains  one  CSU,  soil.c. 


BBN  Systems  and  Tec^'aologies 


MCC  CSCI 


2. 1.3.1  soil.c 

/simnet  'mccA^  other/soil  .c 

ooil.c  contains  a  routine  for  checking  soil  versus  pitch  and  cant. 

2. 1.3. 1.1  SoilOkay 

SoilOkay  determines  if  the  soil,  given  by  soilT ype,  is  acceptable  f  '  a  given  vehicle  at  a 
given  pitch  and  cant,  determined  by  rotation.  Tbe  function  call  is  SoilOkay(soilType, 
rotation).  Table  2.1-71  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

soilType 

int 

Standard  C  type. 

rotation 

3  by  3  matrix  of  double 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

Soil  is  unacceptable. 

1 

int 

Soil  is  acceptable. 

I  Calls  I 

Function 

Where  Described 

PITCH  SIN 

Macro  defined  in  /simnet/mcc/Mother/soil.c. 

CANT  SIN 

Macro  defined  in  /simnet/mcc'Mother/soil.c. 

I  Called  Bv  I 

Function 

Where  Described 

FindAnOpenSpot 

Section  2. 1.2. 5.1. 

Table  2.1-71:  SoilOkay  Information. 


2.1.4  Activating  Combat  Vehicle  Simulators 

This  keeps  a  separate  list  of  activate  locations  which  are  used  to  determine  whether  a 
vehicle  was  initialized  at  a  particular  location  from  this  MCC,  but  is  not  yet  issuing  vehicle 
appearance  packets.  This  is  done  to  prevent  more  than  one  vehicle  from  being  placed  in  the 
same  location.  It  activates  combat  vehicle  simulators  and  ascertains  whether  they  are  being 
activated  for  the  first  time,  due  to  a  reconstitution,  or  due  to  a  towing  arrival.  The  type  of 
activation  is  used  to  determine  the  state  and  status  of  the  vehicle.  The  following  CSUs 
perform  these  functions: 

actloc.c 

sim.c 
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2. 1.4.1  actloc.c 

/simnet/mcc/Mother/actlcx:.c 

actloc.c  contains  routines  which  keep  track  of  where  vehicles  have  been  activated.  This 
prevents  one  vehicle  from  being  activated  on  top  of  another  vehicle  before  the  first  has  had 
a  chance  to  send  out  appearance  packets.  Table  2.1-72  shows  the  variables  used  by 
actloc.c. 


1  Variables  | 

Variable 

Type 

Where  Typedef  Declared 

Act  List 

pointer  to  FQueue  Head  t 

/simnet/mcc/libmcc/fqueue.h 

Table  2.1-72:  actloc.c  Variable  Information. 

2. 1.4. 1.1  ActListHash 

Act_List_Hash  is  a  hash  function  used  to  index  the  activation  entries,  key  is  a  pointer  to 
three  unsigned  integers  which  are  used  to  lookup  the  activating  location  of  the  vehicle. 
Hash  Size  is  a  pointer  to  an  integer  which  is  the  size  of  the  hash  table  used  to  lookup  the 
entries  in  the  activation  location  table.  The  function  call  is  Act_List_Hash(Key, 
Hash_Size).  Table  2.1-73  describes  the  parameters  used  by  this  function. 


Parameters 


Parameter 

Type 

Where  Typedef  Declared 

Key 

register  pointer  to  unsigned 
short 

Standard  C  type. 

Hash  Size 

pointer  register  long 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

index 

register  unsigned  long 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

index 

unsigned  short 

Index  of  activation  entry. 

Table  2.1-73:  Act  List  Hash  Information. 

2. 1.4. 1.2  ActListAlloc 

Act_List_Alloc  returns  a  pointer  to  memory  to  use  for  the  activation  table.  Size  is  the  size 
in  bytes  of  the  area  of  memory  to  allocate.  Hash  Size  is  the  size  of  the  hash  table.  The 
function  call  is  Act_List_Alloc(Size,  Hash_Size).  Table  2.1-74  describes  the  parameters 
used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Size 

unsigned  int 

Standard  C  type. 

Hash  Size 

Standard  C  type. 
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1  Return  Values  I 

Return  Value 

Type 

Meaning 

((char  )maltoc  (Size)) 

pointer  to  char 

Pointer  to  memory  area 
allocated. 

Table  2,1-74:  Act  List  Alloc  Information. 


2. 1.4. 1.3  Act  List  Init 


Act_List_Init  initializes  the  activation  list.  The  function  call  is  Act_List_Init(). 

Table  2.1-75  describes  the  internal  variable  used  and  functions  called  using  this  function. 


1  Internal  Variables  I 

1  Variable 

Type 

Where  Typedef  Declared 

pointer  to  int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

FQueue  Create 

Section  2.21.1.13.3. 

1  Called  By  I 

Function 

Where  Described 

Init  MCC  Processing 

Section  2. 1.1. 2.8. 

Table  2.1-75:  Act  List  Init  Information. 


2. 1.4. 1.4  Act_List_Add 

Act_List_Add  adds  a  vehicle  to  the  list  of  activation  locations  of  which  to  keep  track. 
VehiclelD  is  the  vehicle  ID  of  the  vehicle  to  add  to  the  list.  It  specifies  uniquely  the  vehicle 
being  saved.  Location  is  the  location  of  the  vehicle  to  be  stored.  The  function  call  is 
Act_List_Add(VehiclelD,  Location).  Table  2.1-76  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameter 


VehiclelD 


Location 


Parameters 


pointer  to  VehiclelD 


array  of  float 


Where  Typedef  Declared 


/simnet/common/include/prot 

ocol/basic.h 


Standard  C  type. 


Variable 


Act  Entr 


status 


Internal  Variables 


e 


Actiyate  Ent 


int 


Where  Typedef  Declared 


/simnet/mcc/Mother/actloc.c 


Standard  C  type. 


Return  Value 


Type 

Meaning 

char 

Successful. 

char 

Unsuccessful. 

-1 
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1  Calls  1 

Function 

Where  Described 

FQueue  Insert 

Section  2.21.1.13.4. 

Called  By 

Function 

Where  Described 

ActivateVehicle 

Section  2, 1.4.2. 8. 

Table  2.1-76:  Act  List  Add  Information. 


2. 1.4. 1.5  Act_List_DeIete 

Act_List_Delete  removes  an  entry  from  the  activation  list.  The  function  call  is 
Act_List_Delete(VehicleID).  Table  2.1-77  describes  the  parameters  used  and  functions 
called  using  this  function. 


Parameter 


VehiclelD 


Variable 


status 


Parameters 


pointer  to  VehiclelD 


Internal  Variables 


e 


Where  Tvoedef  Declared 


/simnet/common/include/prot 

ocol/basic.h 


Where  Typedef  Declared 


Standard  C  type. 


Return  Values 


Return  Value 


-1 


0 


Type 


char 


char 


Meaning 


Unsuccessful. 


Successful. 


Calls 

Function 

Where  Described 

FQueue  Remove 

Section  2.21.1.13.5. 

Function 


ActivateRepIvTimedOut 


CheckSimulatorActivit 


Called  B 


Where  Described 


Section  2.1. 4.2.7. 


Section  2.1.4.2.12 


Table  2.1-77:  Act_List_Delete  Information. 
2. 1.4. 1.6  Act  List  Loc  Exists 


Act_List_Loc_Exists  determines  if  a  given  location  is  near  a  vehicle  which  is  already 
activating.  The  function  call  is  Act_List_Loc_Exists(Location,  Radius).  Table  2.1-78 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Location 

array  of  float 

Standard  C  type. 

Radius 

unsianed  int 

Standard  C  type. 
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Internal  Variables 

Variable 

Where  Typedef  Declared 

Entry  Ptr 

pointer  to  FQueue  Head  t 

/simnet/mcc/libmcc/fqueue.h 

Activate  Entry 

Activate  Entry  t 

/simnet/mcc/Mother/actloc.c 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

char 

Location  not  near  activating 
vehicle. 

-1 

char 

Location  near  activating 
vehicle. 

1  Calls  1 

Function 

Where  Described 

FQueue  Scan 

Section  2.21.1.13.6. 

DISTANCE 

Macro  defined  in  /simnet/mcc/Mother/actloc.c. 

1  Called  By  I 

Function 

Where  Described 

FindAnOpenSpot 

Section  2.1. 2.5.1. 

Table  2.1-78:  Act  List  Loc  Exists  Information. 


2. 1.4.2  sim.c 

/simnet/mccAlother/sim.c 

sim.c  contains  routines  for  activating  and  deactivating  combat  simulators. 

2. 1.4.2. 1  UpdateAppearance 
UpdateAppearance  is  a  dummy  function.  The  function  call  is 

UpdateAppearance(vehicleID,  PDU).  Table  2.1-79  describes  the  parameters  used  by  this 
function. 


1  Parameters 

Parameter 

Type 

Where  Typedef  Declared 

vehiclelD 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

PDU 

pointer  to  SimulationPDU 

/simnet/common/include/prot 
ocol/p  sim.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

angle 

float 

Standard  C  type. 

rot 

float 

Standard  C  type. 

rotation 

3  by  3  matrix  of  double 

Standard  C  type. 

Table  2.1-79:  UpdateAppearance  Information. 
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2 . 1 . 4 . 2 . 2  ActivateForExerciseStart 

ActivateForExerciseStart  activates  a  simulator  at  the  start  of  an  exercise.  requestID  is  the 
identifier  marking  this  request  for  activation,  and  is  used  to  send  a  reply  message  back  to 
the  requestor,  msg  is  the  "act"  structure  part  of  MCCMessageBuffer  used  to  lookup  and 
set  information  needed  for  activating  a  simulator  on  the  network,  sim  is  a  pointer  to  the 
internal  simulator  status  maintained  by  the  MCC  for  the  activated  simulator.  The  function 
call  is  ActivateForExerciseStart(requestID,  msg,  sim).  Table  2.1-80  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

requestID 

long 

Standard  C  type. 

msg 

pointer  to  MCCMessageBuffer 

/simnet/mcc/include/MCCJpc 

■h 

sim 

pointer  to  pointer  to 
SimulatorStatus 

/simnet/mcc/include/veh_tabl 

e.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

tmpsim 

register  pointer  to 
SimulatorStatus 

/simnet/mcc/include/vehjabl 

e.h 

i 

register  int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

1 

int 

Simulator  already  placed  and 
can’t  be  activated. 

0 

int 

Simulator  activated. 

Calls 

Function 

Where  Described 

SendRsp 

Section  2.21.2.10.8. 

Called  By 

Function 

Where  Described 

ActivateVehicle 

Section  2.1. 4.2.8. 

Table  2.1-80:  ActivateForExerciseStart  Information. 

2. 1.4. 2. 3  ActivateForReconstitution 

ActivateForReconstitution  activates  a  vehicle  that  is  being  reconstituted.  requestID  is  the 
identifier  marking  this  request  for  activation,  and  is  used  to  send  a  reply  message  back  to 
the  requestor,  msg  is  the  "act"  structure  part  of  MCCMessageBuffer  used  to  lookup  and 
set  information  needed  for  activating  a  simulator  on  the  network,  sim  is  a  pointer  to  the 
internal  simulator  status  maintained  by  the  MCC  for  the  activated  simulator.  The  function 
call  is  ActivateForReconstitution(requestID,  msg,  sim).  Table  2.1-81  describes  the 
parameters  used  and  functions  called  using  this  function. 
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Parameter 


request  ID 


msg 


Parameters 


Where  Typedef  Declared 


Standard  C  tvoe. 


pointer  to  MCCMessageBuffer  I  /simnel/mcc/include/MCCJpc 


pointer  to  pointer  to 
SimulatorStatus 


/simnetymcc/include/veh_tabl 
■  h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

veh 

pointer  to  VehiclelDStatus 

/simnet/mcc/include/veh_tabl 

e.h 

tmpsim 

register  pointer  to 
SimulatorStatus 

/simnet/mcc/include/veh_tabl 

e.h 

Standard  C  type. 


Return  Values 

Return  Value 

Type 

Meaning 

1 

int 

Unsuccessful. 

Successful. 


Function 


FQueue  Retrieve 


SendRs 


Calls 


Where  Described 


Section  2.21.1.13.7. 


Section  2.21.2.10.8. 


Function 


ActivateVehicle 


Called  B 


Where  Described 


Section  2.1.4.2  8. 


Table  2.1-81;  ActivateForReconstitution  Information. 


2. 1.4. 2. 4  ActivateForTowingArrival 

ActivateForTowingAnival  activates  a  vehicle  when  it  reaches  it  towing  destination. 
requestID  is  the  identifier  marking  this  request  for  activation,  and  is  used  to  send  a  reply 
message  back  to  the  requestor,  msg  is  the  "act"  structure  part  of  MCCMessageBuffer  used 
to  loolmp  and  set  information  needed  for  activating  a  simulator  on  the  network.  It  is  a 
dummy  function.  The  function  call  is  ActivateForTowingArrival(requestJD,  msg).  Table 
2.1-82  describes  the  parameters  used  by  this  function. 


Parameters _ _ 

Parameter _ Type _ Where  Typedef  Declared 

requestID _ long _ Standard  C  type. _ 

msg  pointer  to  MCCMessageBuffer  /simnet/mcc/include/MCCjpc 

.h  _ 


Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

Always  returned. 
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Called  B 


Function 

Where  Described 

ActivateVehicle 

Section  2. 1.4. 2.8. 

Table  2.1-82:  ActivateForTowingArrival  Information. 


2. 1.4. 2. 5  Build  ActivatePDU 


Build_ActivatePDU  creates  an  Activate  PDU  for  a  simulator.  PDU  is  the 
ActivateRequest Variant  simulation  PDU.  msg  is  the  MCCMessageBuffer  containing  the 
"act"  structure  used  by  this  routine  for  information  about  this  activation  attempt. 
simAddress  is  the  SIMNET  simulator  address  of  the  vehicle  being  activated,  bumper  is  the 
bumper  number  (a  license  plate  type  of  number)  used  by  this  routine  to  fill  in  part  of  the 
"text"  part  of  the  "marking"  field  in  the  activation  variant.  The  function  call  is 
Build_ActivatePDU(PDU,  msg,  simAddress,  location).  Table  2.1-83  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

PDU 

pointer  to  Simulation  PDU 

/simnet/common/include/prot 
ocol/p  sim.h 

msg 

pointer  to  MCCMessageBuffer 

/simnet/mcc/include/MCCJpc 

.h 

simAddress 

pointer  to  SimulationAddress 

/simnet/common/include/prot 

ocol/address.h 

location 

array  of  float 

Standard  C  type. 

_  Internal  Variables  _ 

Variable  Type  Where  Typedef  Declared 

aPDU  register  pointer  to  /simnet/common/include/prot 

_ ActivateRequestVariant _ ocol/p  sim.h _ 

vaPDU  pointer  to  /simnet/common/include/prot 

_ VehicleAppearanceVariant  ocol/p  sim.h _ 

veh  pointer  to  VehiclelDStatus  /simnet/mcc/include/veh_tabl 

_ ej] _ 

unitID  Unitidentifier  /simnet/common/include/prot 

_ ocol/basic.h _ 

bumper_ pointer  to  unsigned  int_ Standard  C  type. 


Return  Values 


Return  Value _ Type _ Meaning 

1 _ int _ Unsuccesslul. 

0  int  Successful. 


Calls 

Function 

Where  Described 

FQueue  Retrieve 

Section  2.21.1.13.7. 

mil  to  fixedpt 

Section  2.21.1.5.1. 
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1  Called  Bv  1 

Function 

Where  Described 

ActivateVehicle 

Section  2.1 .4.2.8. 

Table  2.1-83:  Build_ActivatePDU  Information. 

2. 1.4. 2. 6  ActivateRepIyReceived 

ActivateRepIyReceived  is  called  when  a  response  is  received  to  a  Activate  request 
transaction.  PDU  is  the  activate  response  variant  received  when  the  simulator  being 
activated  responds  to  the  MCC  activate  request.  PDU  Len  is  the  size  of  the  receiv^  PDU 
in  bytes.  Respondent  is  the  SimiilatorAddress  of  the  simulator  responding  to  the  activate 
request.  Actjnfo  contains  information  about  the  simulator's  entry  in  the  MCC  local 
simulator  table.  The  function  call  is  ActivateReplyReceived(PDU,  PDU_Len,  Respondent, 
Act_Info).  Table  2.1-84  describes  the  parameters  used  and  functions  called  using  this 
function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

PDU 

pointer  to  SimulationPDU 

/simnet/common/include/prot 
ocol/p  sim.h 

PDU  Len 

Iona  int 

Standard  C  type. 

Respondent 

pointer  to  Simulatioi  Address 

/simnet/common/include/prot 

ocol/address.h 

Act  Info 

pointer  to  VMisc  Data  t 

/si  m  net/mc/M  ot  he  r/s  i  m .  c 

Internal  Variables 

Variable 

Where  Typedef  Declared 

aPDU 

register  pointer  to 

Activate  ResponseVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

tmp_veh 

VehiclelDStatus 

/simnet/mcc/include/veh_tabl 

e.h 

status 

int 

Standard  C  type. 

I  Calls  I 

Function 

Where  Described 

FQueue  Insert 

Section  2.21.1.13.4. 

FQueue  Retrieve 

Section  2.21.1.13.7. 

Table  2.1-84:  ActivateRepIyReceived  Information. 

2. 1.4. 2. 7  ActivateRepIyTimedOut 

ActivateReplyTimedOut  is  called  when  a  simulator  which  the  MCC  tried  to  activate  did  not 
send  a  reply.  PDU  is  the  activate  request  variant  sent  to  the  simulator.  PDU  Len  is  the 
size  of  the  PDU  in  bytes.  Respondent  is  the  SimulatorAddress  of  the  simulator  being 
requested  to  activate.  Actjnfo  contains  information  about  the  simulator's  entry  in  the 
Mte  local  simulator  table.  The  function  call  is  ActivateReplyTimedOut(PDU,  PDU_Len. 
Respondent,  Act_Info).  Table  2.1-85  describes  the  parameters  used  and  functions  called 
using  this  function. 
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1  Parameters  j 

Parameter 

Where  Typedef  Declared 

PDU 

pointer  to  SimulationPDU 

/simnet/common/include/prot 
ocol/p  sim.h 

PDU  Len 

Iona  int 

Standard  C  type. 

Respondent 

pointer  to  SimulationAddress 

/simnet/common/include/prot 

ocol/address.h 

Act  Info 

pointer  to  VMisc  Data  t 

/simnet/mcc/Mother/sim.c 

Internal  Variables 

Variable 

Where  Typedef  Declared 

aPDU 

register  pointer  to 

Activate  RequestVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

tmp_id 

VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

msg 

MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

1  Calls  1 

Function 

Where  Described 

SendMCCMsgt 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

VehicleTolDTrailer 

Section  2.21.1.11.4. 

Act  List  Delete 

Section  2.1 .4.1 .5. 

Table  2.1-85:  ActivateRepIyTimedOut  Information. 

2. 1.4. 2. 8  ActivateVehicle 

ActivateVehicle  activates  a  vehicle  simulator.  requestID  is  an  identifier  to  use  when 
returning  a  response  to  the  YUMM  request  asking  for  activation  and  msg  is  the  message 
sent  to  Mother  asking  for  the  activation.  If  the  vehicle  is  being  activated  because  it  is 
arriving  at  a  towing  destination,  only  its  location  and  orientation  (not  status)  need  to  be 
supplied  by  the  requesting  process. 

Errors  are  signalled  for  the  following  conditions; 

—  No  clear  place  on  the  terrain  can  be  found  to  place  the  vehicle 
—  The  reason  for  activation  is  not  among  those  known  to  the  MCC 
—  The  ActivateForExerciseStart,  ActivateForReconstitution,  or 
ActivateForTowingArrival  routines  return  a  non-zero  status 
—  Some  part  of  the  activation  information  is  invalid,  as  returned  by 
B  uild_ActivatePDU 

—  There  is  no  room  in  the  activation  list  to  add  the  location  of  the  vehicle 
—  The  network  cannot  be  accessed  successfully 

The  function  call  is  ActivateVehicle(requestID,  msg).  Table  2.1-86  describes  the 
parameters  used,  errors  returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

requestID 

lonq 

Standard  C  type. 

msg 

register  pointer  to 
MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

1  1 
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Variable 


tmpmsg 


vehiclelD 


simAddress 


Act  Info 


location 


theta 


rotation 


status 


unitID 


Internal  Variables 


e 


MCCMessageBuffer 


VehiclelD 


SimulationPDU 


pointer  to  SimulationAddress 


pointer  to  SimulatorStatus 


ointer  to  VMisc  Data  t 


arrav  3  of  float 


double 


3  by  3  matrix  of  double 


int 


pointer  to  Unitidentifier 


Where  Tvoedef  Declared 


/simnet/mcc/include/MCCJpc 

.h 


/simnet/common/include/prot 

ocoi/basic.h 


/simnet/common/include/prot 
ocol/p  sim.h 


/simnet/common/include/prot 

ocol/address.h 


/simnet/mcc/include/veh_tabl 

e.h 


/simnet/mcc/Mother/sim.c 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


/simnet/common/include/prot 

ocol/basic.h 


Error  Name 


MCC  ACTIVATE  FAILED 


MCC  ACTIVATE  BAD 


MCC  ACTIVATE  ASSFAIL 


Errors 


Reason  for  Error 


The  simulator  replied  to  the  activate  reauest  but  did  not  start. 


Corrupt  activate  sent  to  simulator. 


Function 


FindAnOpenSpot 


miLto_rad 


SendRs 


ActivateForExerciseStart 


ActivateForReconstitution 


Activate  ForT  owinq  Arrival 


VehiclelDToTrailer 


TotalVehicleFuel 


Build  ActivatePDU 


FQueue  Retrieve 


AssocSendT  ransact 


PRO_SIM_ACTIVATE_REQ_ 

SIZE 


SendMCCMsql 


AssocError 


Act  List  Add 


Calls 


Where  Described 


Section  2.1. 2.5.1, 


Macro  defined  in 

/simnet/common/include/qlobal/sim  macros. h. 


Section  2.21.2.10.8. 


Section  2. 1.4. 2. 2. 


Section  2. 1.4. 2.3. 


Section  2. 1.4. 2. 4. 


Section  2.21.1.11.4. 


Section  2.21.1.28.1. 


Section  2.1. 4.2.5. 


Section  2.21.1.13.7. 


Section  2.20.1.4.1. 


Macro  defined  in  /simnet/common/include/protocol/p_size.h 


Macro  defined  in  /simnet/mcc/include/MCC  i 


Section  2.20.1.10.1. 


Section  2. 1.4. 1.4. 


Called  B 


Function 

Where  Described 

ProcessMessaqe 

Section  2. 1.1. 2.1. 

Table  2.1-86:  ActivateVehicle  Information. 
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1.1  A. 1.9  DeactivateReplyReceived 

DeactivateReplyReceived  is  called  when  a  response  is  received  to  a  deactivate  request. 
PDU  is  the  deactivate  response  variant  receiveJd  when  the  simulator  being  deactivated 
responds  to  the  MCC  deactivate  request.  PDUJLen  is  the  size  of  the  received  PDU  in 
bytes.  Respondent  is  the  SimulatorAddress  of  the  simulator  responding  to  the  deactivate 
r^uest.  Deactjnfo  contains  information  about  the  simulator's  entry  in  the  MCC  local 
simulator  table.  An  error  is  signalled  if  the  MCC  received  a  response  from  a  simulator  that 
was  not  currently  being  deactivated.  The  function  call  is  DeactivateReplyReceived(PDU, 
PDU_Len,  Respondent,  Deactjnfo).  Table  2.1-87  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Tvoe 

Where  Typedef  Declared 

PDU 

pointer  to  Simulation  PDU 

/simnet/common/include/prot 
ocol/p  sim.h 

PDU  Len 

unsiqned  int 

Standard  C  type. 

Respondent 

pointer  to  SimulationAddress 

/simnet/common/include/prot 

ocol/address.h 

Deact  Info 

pointer  to  VMisc  Data  t 

/simnet/mcc/Mother/sim.c 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

dPDU 

pointer  to 

DeactivateResponseVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

Errors 

Error  Name 

Reason  for  Error 

MCC  DEACTIVATE  BASRS 

P 

Deactivate  failed. 

Table  2.1-87:  DeactivateReplyReceived  Information. 

2.1.4.2.10  DeactivateRepIyTimedOut 

DeactivateReplyTimedOut  is  called  when  no  response  is  received  to  a  deactivate  request. 
PDU  is  the  deactivate  request  sent  to  the  simulator  being  by  the  MCC.  PDU  Len  is  the 
size  of  the  PDU  in  bytes.  Respondent  is  the  SimulatorAddress  of  the  simulator  being 
deactivated.  Deactjnfo  contains  information  about  the  simulator's  entry  in  the  MCC  local 
simulator  table.  The  function  call  is  DeactivateReplyTimedOut(PDU,  PDU_Len, 
Respondent,  Deactjnfo).  Table  2.1-88  describes  the  parameters  used,  errors  returned  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

PDU 

pointer  to  Simulation  PDU 

/simnet/common/include/prot 
ocol/p  sim.h 

PDU  Len 

unsianed  int 

Standard  C  type. 

Respondent 

pointer  to  SimulationAddress 

/simnet/common/include/prot 

ocol/address.h 

Deact  Info 

pointer  to  VMisc  Data  t 

/simnet/mcc/Mother/sim.c 

1  , 
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1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

dPDU 

pointer  to 

DeactivateRequestVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

1  Errors  I 

Error  Name 

Reason  for  Error 

MCC  DEACTIVATE  FAILED 

Simulator  could  not  be  deactivated. 

1  Calls  1 

Function 

Where  Described 

VehicleTolDTrailer 

Section  2.21.1.11.4. 

Table  2.1-88:  DeactivateRepIyTimedOut  Information. 


2.1.4.2.11  DeactivateVehicIe 

DeactivateVehicle  deactivates  a  vehicle  simulator,  vehiclelD..  by  broadcasting  the 
appropriate  number  of  Deactivate  PDUs.  The  function  call  is  DeactivateVehicle(vehiclelD). 
Table  2.1-89  describes  the  parameters  used,  errors  returned  and  functions  called  using  this 
function. 


Parameters _ _ 

Parameter _  Type  I  Where  Typedgf  Declared 

vehiclelD  pointer  to  VehiclelD  /simnet/common/include/prot 


ocol/basic.h 


_  Internal  Variables  _ 

Variable  Type  Where  Typedef  Declared 

PDU  SimulationPDU  /simnet/common/include/prot 

_ ocol/p  sim.h _ 

dPDU  pointer  to  /simnet/common/include/prot 

_ DeactivateRequestVariant  ocol/p  sim.h _ 

veh  pointer  to  VehiclelDStatus  /simnet/mcc/include/vehjabi 

_ _ ej] _ 

status _ [nt _ Standard  C  type. _ 

Deact  Info  pointer  to  VMisc  Data  t  /simnet/mcc/Mother/sim.c 


Errors 


Error  Name _ Reason  for  Error 

MCC_DEACTIVATE_ASSFAI  Send  failed  deactivating. 
L 


Calls 

Function 

Where  Described 

FQueue  Retrieve 

Section  2.21.1.13.7. 

AssocSendTransact 

Section  2.20.1.4.1. 

PRO  SIM  DEACTIVATE  RE 
Q  SIZE 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

AssocSendDataqram 

Section  2.20.1.2.1. 

AssocError 

Section  2.20.1.10.1. 
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1  Called  Bv  1 

Function 

Where  Described 

ProcessMessaqe 

Section  2. 1.1. 2.1. 

BroadcastCCVBalch 

Section  2. 1.2.3. 2. 

PlaceCCV 

Section  2. 1.2. 6.1. 

DeactivateAllVehicles 

Section  2. 1.5. 1.2 

Table  2.1-89:  DeactivateVehicle  Information. 


2.1.4.2.12  CheckSimulatorActivity 

CheckSimulatorActivity  monitors  the  receipt  of  Vehicle  Appearance  PDUs.  An  error  is 
signalled  if  a  simulator  which  the  MCC  activated  suddenly  stops  broadcasting  packets  on 
the  network,  and  a  message  is  sent  to  the  SCC  indicating  that  the  simulator  may  have  some 
problem.  The  function  call  is  CheckSimulatorActivity().  Table  2.1-90  describes  the 
internal  variables  used,  errors  returned  and  functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

veh 

register  pointer  to 
VehiclelDStatus 

/simnet/mcc/include/veh_tabl 

e.h 

vlist  ptr 

pointer  to  FQueue  t 

/simnet/mcc/libmcc/fqueue.h 

msg 

MCCMessageBuffer 

/simnet/mcc/include/MCCJpc 

.h 

vaPDU 

pointer  to 

VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

timedOut 

int 

Standard  C  type. 

OldPacket 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

checkSimulatorPeriod 

int 

Delay  time  until  fuction  can  be 
called  again. 

checkSimulatorPeriod  is  a 
constant  defined  in 
/simnet/mcc/include/MCCjim 
ers.h 

1  Errors  1 

Error  Name 

Reason  for  Error 

MCC  SIM  LOST 

Simulator  stopped  unexpectedly. 

1  Calls  1 

Function 

Where  Described 

FQueue  Scan 

Section  2.21.1.13.6. 

FQueue  Retrieve 

Section  2.21.1.13.7. 

Act  List  Delete 

Section  2. 1.4. 1.5. 

SendMCCMsgl 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h 

VehiclelDToTrailer 

Section  2.21.1.11.4. 

FQueue  Remove 

Section  2.21.1.13.5. 

Table  2.1-90:  CheckSimulatorActivity  Information. 
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2.1.5  Recording  Statistics 

This  writes  out  two  files  at  the  end  of  the  exercise:  ExerciseLog  and  VehicleLog.  These 
keep  track  of  information  during  the  exercise.  The  start  and  end  times  of  the  exercise  are 
noted,  and  certain  vehicle  information,  e.g.  ammo  used,  distance  travelled,  etc.  are  traced. 
This  functionality  is  provided  by  one  CSU,  shutdown.c. 


2. 1.5.1  shutdown.c 

/simnet/mccAlother/shutdown.c 

shutdown.c  contains  several  routines  which  are  called  during  exercise  shutdown,  MCC 
system  exit  and  host  powerdown. 

2. 1.5. 1.1  ResetMCC 

ResetMCC  completely  resets  the  MCC  and  ends  the  current  exercise  if  one  exists,  fast  is 
normally  0  when  in  a  normal  reset  or  shutdown  of  the  MCC.  Generally  the  MCC  will  send 
out  deactivate  packets  to  vehicles  which  it  has  activated  when  shut  down.  When  a  "fast" 
shutdown  is  specified,  the  MCC  skips  the  phase  of  deactivating  simulators  and  the 
simulators  remain  in  their  previous  state.  The  function  call  is  ResetMCC(fast).  Table  2.1- 
91  describes  the  parameter  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

fast 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

SendMCCMsqO 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

KillServiceProcesses 

Section  2. 1.5. 1.3. 

LoqExerciseEnd 

Section  2. 1.5. 1.4. 

DeactivateAlIVehicles 

Section  2. 1.5. 1.2. 

tdb  terminate 

Section  2,21.7.27.2. 

YUMMCleanUo 

Section  2.21.2.10.5. 

RemoveLocks 

Section  2.21.2.6.5. 

RemoveSharedMem 

Section  2.21.2.7.2. 

CloseNetworklnterface 

Section  2.21.1.22.4. 

Called  By 

Function 

Where  Described 

main 

Section  2. 1.1. 2.9. 

Table  2.1-91:  ResetMCC  Information. 

2. 1.5. 1.2  DeactivateAlIVehicles 

DeactivateAllVehicles  deactivates  each  vehicle  currently  active.  The  function  cal!  is 
DeactivateAllVehiclesO.  Table  2.1-92  describes  the  internal  variables  used  and  functions 
called  using  this  function. 
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1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

Sim 

register  pointer  to 
SimulatorStatus 

/simnet/mcc/include/veh_tabl 

e.h 

veh 

register  pointer  to 
VehiclelDStatus 

/simnet/mcc/include/vehjabi 

e.h 

Calls 

Function 

Where  Described 

FQueue  Retrieve 

Section  2.21.1.13.7. 

DeactivateVehicle 

Section  2.1.4.2.11. 

Called  By 

Function 

Where  Described 

ResetMCC 

Section  2. 1.5. 1.1. 

Table  2.1-92:  DeactivateAIIVehicles  Information. 

2. 1.5. 1.3  KillServiceProcesses 

KillServiceProcesses  terminates  each  of  the  service  processes  spawned  by  the  Mother 
process.  The  function  call  is  KillServiceProcesses().  Table  2.1-93  describes  the  internal 
variable  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

errno  I 

extern  int 

Standard  C  type. 

Calls 

Function 

Where  Described 

SiqnalChild 

Section  2.21.1.26.4. 

Called  By 

Function 

Where  Described 

ResetMCC 

Section  2. 1.5. 1.1. 

Table  2.1-93:  KillServiceProcesses  Information. 

2. 1.5. 1.4  LogExerciseEnd 

LogExerciseEnd  logs  the  statistics  to  log  files  following  an  exercise.  The  function  call  is 
Lx>gExerciseEnd().  Table  2. 1-94  describes  the  internal  variables  used  and  functions  called 
using  this  function. 
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1  Internal  Variables  I 

Variable 

Type 

Where  Tvpedef  Declared 

Sim 

register  pointer  to 
SimulatorStatus 

/simnet/mcc/include/veh_tabl 

e.h 

veh 

register  pointer  to 
VehiclelDStatus 

/simnet/mcc/include/yeh_tabl 

e.h 

CP 

register  pointer  to  char 

Standard  C  type. 

i 

short 

Standard  C  type. 

i 

short 

Standard  C  type. 

totalDistance 

float 

Standard  C  type. 

totalFuel 

float 

Standard  C  type. 

totalAmmo 

array  numberAmmoCounters 
of  long 

Standard  C  type. 

dateStrinq 

array  20  of  char 

Standard  C  type. 

startTime 

array  20  of  char 

Standard  C  type. 

endTime 

array  20  of  char 

Standard  C  type. 

exerciseKey 

array  20  of  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

TimeStrinq 

Section  2. 1.5. 1.5. 

FQueue  Retrieve 

Section  2.21.1.13.7. 

Called  By 

Function 

Where  Described 

ResetMCC 

Section  2. 1.5. 1.1. 

Table  2.1-94;  LogExerci^eEnd  Information. 


2. 1.5. 1.5  TimeString 

TimeString  creates  a  string  representation  of  a  date  and  time.  Time  is  the  current  time  in 
seconds  since  Jan  1,  1970.  dateString  creates  the  date  of  Time  as  MM.DD.YY  and  returns 
it.  timeString  creates  the  time  of  Time  as  HH.MM.SS  and  returns  it.  The  function  call  is 
TimeString(time,  dateString,  timeString).  Table  2.1-95  describes  the  parameters  used,  and 
functions  called  using  this  function. 


Parameters 


Parameter 


time 


dateStrin 


timeStrin 


Variable 


tm 


IDI:! 


IK 


ointerto  char 


ointerto  char 


Internal  Variables 


e 


ointerto  struct  tm 


Where  Tvpedef  Declared 


Standard  C  tvoe. 


Standard  C  type. 


Standard  C  type. 


Where  Tvpedef  Declared 


Standard  C  structure. 


Called  B 


Function 

Where  Described 

LoqExerciseEnd 

Section  2. 1.5. 1.4. 

Table  2.1-95:  TimeString  Information. 
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2.1.6  Listening  to  the  SIMNET  Local  Area  Network 

This  is  the  CSC  which  reads  packets  in  from  the  SIMNET  local  area  network  and  either 
uses  them  or  distributes  them  to  the  appropriate  console  process.  It  saves  vehicle  status 
packets  and  vehicle  appearance  packets  to  update  its  knowledge  of  the  state  of  the  world.  It 
also  listens  to  impact  packets  and  determines  if  any  of  its  CCVs  have  been  hit.  It  listens  to 
resupply  packets  to  pass  onto  Maim  or  Admin  as  well  as  other  packets  described  in  the 
SIMNET  MCC  Report.  It  is  composed  of  the  following  CSUs: 

maint.c 

protocol.c 


2. 1.6.1  maint.c 

/simnet/mcc/Mother/maint.c 

maint.c  contains  routines  which  handle  repair/service  maintenance  functions.  Table  2.1-96 
shows  the  variables  used  by  maint.c. 


Parameters 


Parameter 


networkinterface 


e 


extern  int 


Where  Tvoedef  Declared 


Standard  C  type. 


Table  2.1-96;  maint.c  Variable  Information. 

2. 1.6. 1.1  RepairReplyReceived 

RepairReplyReceived  is  a  dummy  function.  The  function  call  is 
RepairReplyReceived(PDU,  PDU_Len,  Respondent,  Param).  Table  2.1-97  describes  the 
parameters  used  by  this  function. 


Parameters 


Parameter 


PDU 


PDU  Len 


Respodent 


Param 


pointer  to  Simulation  PDU 


Iona  int 


pointer  to  SimulationAddress  /simnet/common/include/prot 

ocol/address.h 


Where  Tvoedef  Declared 


/simnet/common/include/prot 
ocoi'D  sim.h 


Standard  C  type. 


inter  to  Ion 


Standard  C  type. 


Table  2.1-97:  RepairReplyReceived  Information. 

2. 1.6. 1.2  RepairReplyTimedOut 

RepairReplyTimedOut  is  a  dummy  function.  The  function  call  is 

RepairReplyTimedOut(PDU,  PDU_Len,  Respondent,  Param).  Table  2.1-98  describes  the 
parameters  used  by  this  function. 
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_ j _ Parameters _ _ 

Parameter  Type  Where  Typedef  Declared 

PDU  pointer  to  Simulation  PDU  /simnet/common/include/prot 

_ ocol/p  sim.h _ 

PDU  Len _ long  int _ Standard  C  type. _ 

Respodent  pointer  to  SimulationAddress  /simnet/common/include/prot 

_ ocol/address.h _ 

Param  pointer  to  long  Standard  C  type. 

Table  2.1-98:  RepairRepIyTimedOut  Information. 


2. 1.6. 1.3  Repair_Request 

Repair_Request  is  called  when  the  operator  of  the  Maint  Macintosh  console  has  directed  a 
repair  to  take  place.  The  Main  console  sends  a  sendRepairReq  message  to  the  Mother 
process.  The  request  contains  (within  an  MCCMessageBuffer)  the  information  about  the 
repair  process.  The  message  is  dispatched  on  the  network  as  a  transaction. 
RepairReplyTimedOutO  and  RepairReplyReceived()  are  essentially  placeholder  routines 
which  are  invoked  when  the  repair  response  or  timeout  is  received;  since  the  response 
contains  no  information,  no  processing  is  performed.  requestID  is  the  unique  identifier 
which  identifies  this  transaction,  msg  points  to  the  "repair"  structure  in  the 
MCCMessageBuffer  structure.  The  repair  request  transaction  contains  the  IDs  of  the 
vehicle  being  fixed,  the  vehicle  doing  the  fixing,  and  the  type  of  repair  being  performed. 

An  error  is  signalled  for  the  case  when  the  network  could  not  be  accessed  for  some  reason 
and  a  textural  error  message  is  printed  on  the  MCC  console  via  the  AssocErrorf)  routine  in 
libassoc.  The  function  call  is  Repair_Request(requestID,  msg).  Table  2.1-99  describes  the 
parameters  used,  errors  returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

reguestID 

long 

Standard  C  type. 

msg 

pointer  to  MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

PDU 

SimulationPDU 

/simnet/common/include/prot 
ocol/p  sim.h 

repairPDU 

pointer  to 

RepairReguestVariant 

/simnet/common./include/prot 
ocol/p  sim.h 

status 

int 

Standard  C  type. 

1  Errors  1 

Error  Name 

Reason  for  Error 

MCC  REPAIR  ASSFAIL 

the  network  could  not  be  accessed 

1  Calls  1 

Function 

Where  Described 

AssocSendT  ransact 

Section  2.20.1.4.1. 

PRO  SIM  REPAIR  REQUE 
ST  SIZE 

Macro  defined  in  /simnet/common/include/protocol/p_size.n 

AssocError 

Section  2.20.1.10.1. 

1  1 
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1  Called  By  1 

Function 

Where  Described 

ProcessMessage 

Section  2. 1.1. 2.1. 

Table  2.1-99:  Repair_Request  Information. 

2. 1.6.2  protocol. c 

/simnet/mcc/Mother/protocol.c 

protocol.c  contains  routines  for  processing  PDUs  received  from  the  network. 

2. 1.6.2. 1  SaveVehicleStatus 

SaveVehicleStatus  is  used  to  save  the  status  of  a  vehicle  on  the  network.  The  MCC  uses 
the  status  information  (fuel  remaining,  weapons  available,  fixed/broken  state  of  various 
subsystems,  etc)  when  displaying  information  about  a  simulator  or  activating  the  simulator 
on  the  terrain.  The  information  is  saved  in  the  vehicle  status  list,  vStatusList.  PDU  is  a 
DataCoUection  PDU  pointer  containing  the  VehicleStatusVariant  with  all  of  the  known 
status  information  about  a  vehicle.  An  error  is  signalled  if  there  is  not  enough  room  in  the 
vehicle  status  list  to  add  another  status  entry.  The  function  call  is 
SaveVehicleStatus(PDU).  Table  2.1-100  describes  the  parameters  used,  errors  returned 
and  functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

PDU 

pointer  to  DataCollectionPDU 

/simnet/common/include/prot 
ocol/p  data.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Sim 

pointer  to  SimulatorStatus 

/simnet/mcc/include/veh_tabl 

e.h 

veh 

pointer  to  VehiclelDStatus 

/simnet/mcc/include/veh_tabl 

e.h 

tmp_veh 

VehiclelDStatus 

/simnet/mcc/include/veh_tabl 

e.h 

fuel 

float 

Standard  C  type. 

status 

int 

Standard  C  type. 

I  Errors  I 

Error  Name 

Reason  for  Error 

MCC  VST  QUE  NOMEM 

Vehicle  status  list  out  of  space. 

I  Calls  I 

Function 

Where  Described 

FQueue  Retrieve 

Section  2.21.1.13.7. 

FQueue  Insert 

Section  2.21.1.13.4. 

Lock 

Section  2.21.2.6.3. 

Unlock 

Section  2.21.2.6,4. 

TotalVehicleFuel 

Section  2.21.1.28.1. 
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1  Called  By  I 

Function 

Where  Described 

ProcessDataCoIDataqram 

Section  2.1. 6.2.2. 

Table  2.1-100:  SaveVehicleStatus  Information. 

2. 1.6. 2. 2  ProcessDatColDatagram 

ProcessDatColDatagram  processes  a  datagram  PDU  pertaining  to  the  Data  Collection 
Protocol.  PDU  is  the  Data  Collection  Protocol  Data  Unit  received  from  the  network  for 
processing  by  this  routine.  PDU_Len  is  the  size  of  the  PDU  in  bytes.  Group  is  the 
multicast  group  ID  for  which  this  packet  was  received.  In  Simnet,  the  multicast  group  ID 
is  made  up  of  Ae  protocol  number  and  the  exercise  ID.  Protocol  is  the 
dataCollectionProtocolNumber.  Originator  is  the  Simulation  Address  of  the  simulator 
which  initiated  the  transaction.  TransJD  is  an  internal  identifier  used  by  the  Association 
library  to  associate  the  PDU  with  a  response  which  may  be  sent  to  a  libassoc  transaction. 
Respondent  is  the  Simulation  Address  of  the  simulator  which  is  supposed  to  respond  if  this 
is  a  transaction.  An  error  is  signalled  if  the  Association  library  is  unable  to  access  the 
network.  The  function  call  is  ProcessDatColDatagram(PDU,  PDU_Len,  Group,  Protocol, 
Originator,  Trans_ID,  Respondent).  Table  2.1-101  describes  the  parameters  used  and 
functions  called  using  this  function. 


I  Parameters  { 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

PDU 

pointer  to  DataCollectionPDU 

/simnet/common/include/prot 
ocol/p  data.h 

PDU  Len 

long 

Standard  C  type. 

Group 

MulticastGroupID 

/simnet/common/include/prot 
ocol/p  assoc. h 

Protocol 

AssociationUserProtocol 

/simnet/common/include/prot 
ocol/p  assoc. h 

Originator 

pointer  to  SimulationAddress 

/simnet/common/include/prot 

ocol/address.h 

TransJD 

Transaction  Identilier 

/simnet/common/include/prot 

ocol/address.h 

Respondent 

pointer  to  SimulationAddress 

/simnet/common/include/prot 

ocol/address.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

SaveVehicleStatus 

Section  2.1. 6.2.1. 

ProcessStatusQueryDataqram 

Section  2.1.7.1.10. 

Table  2.1-101:  ProcessDatColDatagram  Information. 
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2 . 1 . 6 . 2 . 3  ProcessDataCoIT  ransaction 

PrcxiessDataColTransaction  processes  a  PDU  pertaining  to  the  Data  Collection  Protocol. 
PDU  is  the  Data  Collection  Protocol  Data  Unit  received  from  the  network  for  processing  by 
this  routine.  PDU  Len  is  the  size  of  the  PDU  in  bytes.  Group  is  the  multicast  group  ID 
for  which  this  packet  was  received.  In  Simnet,  the  multicast  group  ID  is  made  up  of  the 
protocol  number  and  the  exercise  ID.  Protocol  is  the  dataCollectionProtocolNumber. 
Originator  is  the  Simulation  Address  of  the  simulator  which  initiated  the  transaction. 

Trans  JD  is  an  internal  identifier  used  by  the  Association  library  to  associate  the  PDU  with 
a  response  which  may  be  sent  to  a  libassoc  transaction.  Respondent  is  the  Simulation 
Address  of  the  simulator  which  is  supposed  to  respond  to  the  transaction.  An  error  is 
signalled  if  the  Association  library  is  unable  to  access  the  network.  The  function  call  is 
ProcessDataColTransaction(PDU,  PDU_Len,  Group,  Protocol,  Originator,  Trans_ID, 
Respondent).  Table  2.1-102  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

PDU 

pointer  to  DataCollectionPDU 

/simnet/common/include/prot 
ocol/p  data.h 

PDU  Len 

Iona 

Standard  C  type. 

Group 

MulticastGroupID 

/simnet/common/include/prot 
ocol/p  assoc. h 

Protocol 

AssociationUserProtocol 

/simnet/common/include/prot 
ocol/p  assoc. h 

Originator 

pointer  to  SimulationAddress 

/simnet/common/include/prot 
oco  I/address. h 

Trans_ID 

Transaction  Identifier 

/simnet/common/include/prot 

ocol/address.h 

Respondent 

pointer  to  SimulationAddress 

/simnet/common/include/prot 

ocol/address.h 

Calls 

Function 

Where  Described 

ProcessStatusQueryTransacti 

on 

Section  2.1.7.1.11. 

Table  2.1-102:  ProcessDataColTransaction  Information. 

2. 1.6. 2. 4  ProcessMgmtDatagram 

ProcessMgmtDatagram  is  a  dummy  function.  The  function  call  is 
ProcessMgmtDatagram(PDU,  PDU_Len,  Group,  Protocol,  Originator,  Trans_ID, 
Respondent).  Table  2.1-103  describes  the  parameters  used  by  this  function. 
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1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

PDU 

pointer  to  DataCollectionPDU 

/simnet/common/include/prot 
ocol/p  data.h 

PDU  Len 

Iona 

Standard  C  type. 

Group 

MulticastGroupID 

/simnet/common/include/prot 
ocol/p  assoc.h 

Protocol 

AssociationUserProtocol 

/simnet/common/include/prot 
ocol/p  assoc.h 

Originator 

pointer  to  SimulationAddress 

/simnet/common/include/prot 

ocol/address.h 

TransJD 

T  ransaction  Identifier 

/simnet/common/include/prot 

ocol/address.h 

Respondent 

pointer  to  SimulationAddress 

/simnet/common/include/prot 

ocol/address.h 

Table  2.1>103:  ProcessMgmtDatagram  Information. 

2. 1.6. 2. 5  ProcessMgmtTransaction 

ProcessMgmtTransaction  is  a  dummy  function.  The  function  call  is 
ProcessMgmtTransaction(PDU,  PDU_Len,  Group,  Protocol,  Originator,  Trans_ID, 
Respondent).  Table  2.1-104  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

PDU 

pointer  to  DataCollectionPDU 

/simnet/common/include/prot 
ocol/p  data.h 

PDU  Len 

lonq 

Standard  C  type. 

Group 

MulticastGroupID 

/simnet/common/include/prot 
ocol/p  assoc.h 

Protocol 

AssociationUserProtocol 

/simnet/common/include/prot 
ocol/p  assoc.h 

Originator 

pointer  to  SimulationAddress 

/simnet/common/include/prot 

ocol/address.h 

TransJD 

T  ransactionidentifier 

/simnet/common/include/prot 

ocol/address.h 

Respondent 

pointer  to  SimulationAddress 

/simnet/common/include/prot 

ocol/address.h 

Table  2.1-104:  ProcessMgmtTransaction  Information. 

2. 1.6. 2. 6  ProcessSimTransaction 

ProcessSimTransaction  processes  a  simulation  protocol  transaction.  PDU  is  the  Simulation 
Protocol  Data  Unit  received  from  the  network  for  processing  by  this  routine.  PDU  Len  is 
the  size  of  the  PDU  in  bytes.  Group  is  the  multicast  group  ID  for  which  this  packet  was 
received.  In  Simnet,  the  multicast  group  ID  is  made  up  of  the  protocol  number  and  the 
exercise  ID.  Protocol  is  the  simulationftotocolNumber.  Originator  is  the  Simulation 
Address  of  the  simulator  which  initiated  the  transaction.  Trans  ID  is  an  internal  identifier 
used  by  the  Association  library  to  associate  the  PDU  with  a  response  which  may  be  sent  to 
a  libassoc  transaction.  Respondent  is  the  Simulation  Address  of  the  simulator  which  is 
supposed  to  respond  to  the  transaction.  An  error  is  signalled  if  the  Association  library  is 
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unable  to  access  the  network.  The  function  call  is  ProcessSimTransaction(PDU, 
PDU_Len,  Group,  Protocol,  Originator,  Trans_ID,  Respondent).  Table  2.1-105 
describes  ^e  parameters  us^,  errors  returned  and  functions  call^  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

PDU 

pointer  to  SimulationPDU 

/simnet/common/include/prot 
ocol/p  sim.h 

PDU  Len 

Iona 

Standard  C  type. 

Group 

MulticastGroupID 

/simnet/common/include/prot 
ocol/p  assoc. h 

Protocol 

AssociationUserProtocol 

/simnet/common/include/prot 
ocol/p  assoc.h 

Originator 

pointer  to  SimulationAddress 

/simnet/common/include/prot 

ocol/address.h 

TransJD 

T  ransaction  Identifier 

/simnet/common/include/prot 

ocol/address.h 

Respondent 

pointer  to  SimulationAddress 

/simnet/common/include/prot 

ocol/address.h 

I  Internal  Variables  I 

Variable 

Where  Tvpedef  Declared 

veh 

pointer  to  VehiclelDStatus 

/simnet/mcc/include/veh_tabl 

e.h 

ccv 

pointer  to  CCVStatus 

/simnet/mcc/include/vehjabi 

e.h 

status 

int 

Standard  C  type. 

1  Errors  1 

Error  Name 

Reason  for  Error 

MCC  SENDRSP  ASSFAIL 

AssocSendResponse  failed. 

1  Calls  1 

Function 

Where  Described 

FQueue  Retrieve 

Section  2.21.1.13.7. 

AssocSendResponse 

Section  2.20.1.4.2. 

AssocError 

Section  2.20.1.10.1. 

AttackCCV 

Section  2. 1.2. 6. 4. 

Table  2.1-105:  ProcessSimTransaction  Information. 


2. 1.6. 2. 7  Remap_Ammo 


Remap_Ammo  returns  a  manifest  type  ammo  from  a  SIMNET  V6.0  ammo  object, 
anvno  jype.  The  function  call  is  Remap_Ammo(ammo_type).  Table  2.1-106  describes 
the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

ammojype 

ObjectType 

/simnet/common/include/prot 

ocol/basic.h 

BBN  Systems  and  Technologies 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

ammoHEI25 

int 

Type  of  ammo. 

ammoHEAT105 

int 

Type  of  ammo. 

ammoAPDS25 

int 

Type  of  ammo. 

ammoAPDS105 

int 

Type  of  ammo. 

ammoHE107 

int 

Type  of  ammo. 

ammoHE155 

int 

Type  of  ammo. 

ammoMissileTOW 

int 

Type  of  ammo. 

ammoMissileFAAD 

int 

Type  of  ammo. 

ammoHellfire 

int 

Type  of  ammo. 

ammoMaverick 

int 

Type  of  ammo. 

ammoDRAGON 

int 

Type  of  ammo. 

0 

int 

Munition  type  not  recognized. 

Table  2.1-106:  Remap_Ammo  Information. 

2. 1.6. 2. 8  Remap_Fuel 

Remap_Fuel  is  a  dummy  function  which  always  returns  0.  The  function  call  is 
Remap_Fuel(fuel_type).  Table  2.1-107  describes  the  parameters  used  by  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

fueljype 

ObjectType 

/simnet/common/include/prot 

ocol/basic.h 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

Always  returned. 

Table  2.1-107:  Remap_Fuel  Information. 

2. 1.6. 2. 9  ProcessSimDatagram 

ProcessSimDatagram  processes  a  PDU  pertaining  to  the  Simulation  Protocol.  The  function 
call  is  ProcessSimDatagram(PDU,  PDU_Len,  Group,  Protocol,  Originator,  Trans_ID, 
Respondent).  Table  2.1-108  describes  the  parameters  used,  errors  returned  and  functions 
called  using  this  function. 
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Parameter 


PDU 


PDU  Len 


Group 


Protocol 


Originator 


Trans_ID 


Respondent 


Parameters 


pointer  to  SimulationPDU 


MulticastGroupID 


AssociationUserProtocol 


pointer  to  SimulationAddress 


T  ransactionidentifier 


pointer  to  SimulationAddress 


Where  Tvoedef  Declared 


/simnet/common/include/prot 
ocol/p  sim.h 


Standard  C  tvoe. 


/simnet/common/include/prot 
ocol/p  assoc. h 


/simnet/common/include/prot 
ocol/p  assoc.h 


/simnet/common/include/prot 

ocol/address.h 


/simnet/common/include/prot 

ocol/address.h 


/simnet/common/include/prot 

ocol/address.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

veh 

pointer  to  VehiclelDStatus 

/simnet/mcc/include/veh_tabl 

e.h 

ccv 

register  pointer  to  CCVStatus 

/simnet/mcc/include/veh_tabl 

e.h 

supplierlO 

VehiclelD 

/simnet/mcc/include/veh_tabl 

e.h 

unsiqned  short 


pointer  to  MunitionQuantity 


short 


MCCMessageButfer 


Standard  C  tvoe. 


/simnet/common/include/prot 

ocol/basic.h 


Standard  C  type. 


/simnet/mcc/include/MCCJpc 

.h 


Error  Name 


MCC  BAD  SUPPLY 


Errors 


Reason  for  Error 


Vehicle  list  unknown  supply  class. 


Calls 

Function 

Where  Described 

FQueue  Insert 

Section  2.21.1.13.4. 

FQueue  Retrieve 

Section  2.21.1.13.7. 

CountRoundsFired 

Section  2.1.6.2.10. 

IndirectFireDamaae 

SeeSection  2.1. 2.4.6. 

SendMCCMsa2 


Macro  defined  in  /simnet/mcc/include/MCC  i 


Mines_Process_Breach_Data  Section  2.1.8.3.10. 
ram 


Table  2.1-108:  ProcessSimDatagram  Information. 


2.1.6.2.10  CountRoundsFired 


CountRoundsFired  records  the  number  of  rounds  fired  by  a  simulator  for  which  this  MCC 
is  responsible.  vehiclelD  is  a  pointer  to  the  vehicle  ID  of  a  vehicle  which  has  just  fired  off 
a  weapon,  burst  specifies  the  type  and  quantity  of  munitions  fired.  The  function  call  is 
CountRoundsFired(vehicIeID,  burst).  Table  2.1-109  describes  the  parameters  used  and 
functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

vehiclelD 

pointer  to  VehicielD 

/simnet/common/include/prot 

ocol/basic.h 

burst 

pointer  to  BurstDescriptor 

/s  i  mnet/co  mmo  n/i  nclude/prot 
ocol/basic.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Sim 

register  pointer  to 
SimulatorStatus 

/simnet/mcc/include/veh_tabl 

e.h 

Calls 

Function 

Where  Described 

VehiclelDToSim 

Section  2. 1.1. 5.3. 

Called  By 

Function 

Where  Described 

ProcessSirnDataqram 

Section  2. 1.6. 2.9. 

Table  2.1-109:  CountRoundsFired  Information. 


2.1.7  Monitoring  of  the  MCC  System 

This  CSC  monitors  an  event  list,  making  sure  that  events  are  processed  at  the  proper  times. 
Examples  of  events  include  checking  to  see  if  simulators  have  dropped  out  of  the  network, 
checking  to  see  if  artillery  is  due  to  drop,  or  sending  out  exercise  status  or  equipment  status 
PDUs,  etc.  It  also  is  notified  if  the  exercise  has  ended  and  subsequently  deactivates  all  of 
its  vehicles  and  kills  all  of  its  child  processes.  This  functionality  is  realized  by  the 
following  CSUs: 

status.c 

vtimeout.c 


2. 1.7.1  status.c 

/simnet/mcc/Mother/status.c 

status.c  contains  routines  for  reporting  MCC  equipment  and  exercise  status. 

2. 1.7. 1.1  ReportMCCSimuIationStatus 

ReportMCCSimulationStatus  sends  an  MCC  Status  PDU.  An  error  is  signalled  if  the 
Association  library  cannot  access  the  network  to  send  the  MCC  Status  PDU.  The  function 
call  is  ReponMCCSimulationStatus().  Table  2.1-1 10  describes  the  internal  variables  used, 
errors  returned  and  functions  called  using  this  function. 
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Variable 


but 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Standard  C  type. 


array  maxNetworkPDUSize  of 
char 


pointer  to  DataCollectionPDU  /simnet/common/include/prot 

ocol/D  data.h 


Standard  C  type. 


Return  Values 


Return  Value 

Type 

protocolSimulationStatusTime 

1000 

int 

Meaning 


Errors 


Error  Name  Reason  for  Error 


MCC  ASSOC  SNDDGRAM  I  libassoc  cannot  access  the  network 


Function 


Build  Simulation  Status 


AssocSendDataaram 


AssocError 


Calls 


Where  Described 


Section  2. 1.7. 1.7. 


Section  2.20.1.2.1. 


Section  2.20.1.10.1. 


Table  2.1-110:  ReportMCCSimuIationStatus  Information. 

2. 1.7. 1.2  same_unit 

same_unit  checks  to  see  if  two  organizational  units  are  the  same.  The  function  call  is 
same_unit(other,  me).  Table  2.1-1 1 1  describes  the  parameters  used  by  this  function. 


Parameter 


other 


Parameters 


Where  Tvoedef  Declared 


pointer  to  OrganizationalUnit  /simnet/common/include/prot 

ocol/basic.h 


pointer  to  OrganizationalUnit 


/simnet/common/include/prot 

ocol/basic.h 


internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

op 

register  pointer  to 

Unitidentifier 

/simnet/common/include/prot 

ocol/basic.h 

mp 

register  pointer  to 

Unitidentifier 

/simnet/common/include/prot 

ocol/basic.h 

register  int 


Standard  C  type. 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

FALSE 

int 

The  two  units  are  not  the 
same. 

TRUE 

int 

The  two  units  are  the  same. 

Called  By 

Function 

Where  Described 

lanoreStatusQuerv 

Section  2. 1.7. 1.5. 

Table  2.1-111:  same  unit  Information. 


2. 1.7. 1.3  included  unit 


included_unit  determines  whether  me  is  included  by  other.  The  function  call  is 
included_unit(other,  me).  Table  2.1-1 12  describes  the  parameters  used,  errors  returned 
and  functions  called  using  this  function. 


I  Parameters 

Parameter 

Type 

Where  Typedef  Declared 

other 

pointer  to  OrganizationalUnit 

/simnet/common/include/prot 

ocol/basic.h 

me 

pointer  to  OrganizationalUnit 

/simnet/common/include/prot 

ocol/basic.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

op 

register  pointer  to 

Unitidentifier 

/simnet/common/include/prot 

ocol/basic.h 

mp 

register  pointer  to 

Unitidentifier 

/simnet/common/include/prot 

ocol/basic.h 

i 

register  int 

Standard  C  type. 

last  valid  value 

register  int 

Standard  C  type. 

I  Return  Values 

Return  Value 

Type 

Meaning 

FALSE 

int 

Unit  is  not  included  in  other. 

TRUE 

int 

Unit  is  included  in  other. 

I  Called  By 

■  Function  I 

Where  Described 

SeeSection  2. 1.7.1. 5. 

Table  2.1-112:  included  unit  Information. 


2. 1.7. 1.4  including_unit 

including_unit  detemiines  if  other  is  included  by  me.  The  function  call  is 
including_unit(other,  me).  Table  2.1-1 13  describes  the  paiameters  used,  errors  returned 
and  functions  called  using  this  function. 


80 


BBN  Systems  and  Technologies 


MCC  CSCI 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

other 

pointer  to  OrganizationalUnit 

/simnet/common/include/prot 

ocol/basic.h 

me 

pointer  to  OrganizationalUnit 

/simnet/common/include/prot 

ocol/basic.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

op 

register  pointer  to 

Unitidentifier 

/simnet/common/include/prot 

ocol/basic.h 

mp 

register  pointer  to 

Unitidentifier 

/simnet/common/include/prot 

ocol/basic.h 

i 

register  int 

Standard  C  type. 

last  valid  value 

register  int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

FALSE 

int 

Other  is  not  included  in  me. 

TRUE 

int 

Other  is  included  in  me. 

Called  By 

Function 

Where  Described 

lonoreStatusQuery 

Section  2. 1.7. 1.5. 

Table  2.1-113;  including_unit  Information. 
2. 1.7. 1.5  IgnoreStatusQuery 


IgnoreStatusQuery  is  invoked  when  the  MCC  has  received  a  StatusQuery  PDU  from  the 
network.  The  StatusQuery  may  specify  the  kind  of  simulations  which  should  respond  to 
the  query.  This  routine  determines  whether  or  not  the  MCC  meets  the  criteria  specified  in 
the  StatusQuery;  the  routine  returns  1  if  the  MCC  can  safely  ignore  the  query  and  0  if  the 
MCC  must  respond  to  the  query.  StatusQuery  is  the  StatusQueryVariant  which  contains 
information  about  what  kind  of  status  is  requested  by  a  remote  simulator  and  what  type  of 
simulators  should  respond  to  the  query,  exercise  is  the  exercise  in  which  the  MCC  is 
currently  being  run.  If  the  StatusQuery  specifies  exercise  and  the  MCC's  exercise  is 
different,  the  StatusQuery  can  be  ignored.  The  function  call  is  IgnoreStatusQuery(sPDU, 
exercise).  Table  2.1-1 14  describes  the  parameters  used  and  functions  called  using  this 
function. 


_ _ Parameters _ _ 

Parameter  [Type  I  Where  Typedef  Declared 

sPDU  pointer  to  StatusQueryVariant  /simnet/common/include/prot 


_ ocol/p  data.h 

exercise  int  Standard  C  tvoe. 


_  Internal  Variables  _ 

Variable _ Type _ Where  Typedef  Declared 

vehirrelevant  VehiclelD  /simnet/common/include/prot 


ocol/basic.h 
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Return  Values 

Return  Value 

Type 

Meaning 

1 

int 

the  MCC  can  safely  ignore  the 
query 

-1 

int 

an  error  has  occurred 

the  MCC  must  respond  to  the 
ue 


Function 


same  unit 


included  unit 


includino  unit 


Calls 


Where  Described 


Section  2. 1.7.1. 2. 


Section  2. 1.7.1 .3. 


Section  2. 1.7.1. 4. 


Called  B 


Function  1 

Where  Described 

Do  Generic  StatusQuer 

Section  2. 1.7. 1.9. 

Variable 


exerPDU 


Internal  Variables 


e 


pointer  to 

ExerciseStatusVariant 


IE113 


Where  Tvoedef  Declared 


/simnet/common/include/prot 
ocol/p  data.h 


Return  Values 


Return  Value  I  Type 


PRO_DATA_EXERCISE_ST  int 
ATUS  SIZE(dPDU) 


Meaning 


the  size  of  the  PDU 


Function 


PRO_DATA_EXERCISE_ST 
ATUS  SIZE 


Calls 


Where  Described 


Macro  defined  in  /simnet/common/include/protocol/p_size.h 
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1  Called  Bv  1 

Function 

Where  Described 

Do  Generic  StatusQuery 

Section  2. 1.7.1. 9. 

Table  2.1-115:  Build_Exercise_Status  Information. 

2 . 1 . 7 . 1 .7  Build_Simulation_Status 

Build_SimuIation_Status  composes  the  information  in  the  SimulationStatusVariant  and 
returns  the  size  of  the  PDU.  dPDU  is  a  pointer  to  a  SimulationStatusVariant  and  contains 
the  information  from  the  ExerciseStatusVariani  used  in  the  Build_Exercise_Status() 
routine,  as  well  as  unit  organizational  information  and  optional  simulated  elements  specific 
to  the  MCC  system.  The  function  call  is  Build_Simulation_Status(dPDU).  Table  2.1-1 16 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dPDU 

pointer  to  DataCollectionPDU 

/simnet/common/include/prot 
ocol/p  data.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

SPDU 

pointer  to 

SimulationStatusVariant 

/simnet/common/include/prot 
ocol/p  data.h 

unit 

pointer  to  OrganizationalUnit 

/simnet/common/include/prot 

ocol/basic.h 

simnetMCC 

pointer  to 

SIMNET  MCC  Status 

/simnet/common/include/prot 
ocol/p  data.h 

Return  Values 

Return  Value 

Type 

Meaning 

PRO  DATA  SIMULATION  S 
TATUS_SIZE(dPDU,  sPDU- 
>numberUnits)  + 
sizeoKSIMNET  MCC  Status) 

int 

the  size  of  the  PDU 

Calls 

Function 

Where  Described 

PRO  DATA  SIMULATION  S 
TATUS  SIZE 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

Called  By 

Function 

Where  Described 

ReportMCCSimulationStatus 

Section  2.1. 7.1.1. 

Do  Generic  StatusQuery 

Section  2. 1.7. 1.9. 

Table  2.1-116:  BuiId_SimuIation_Status  Information. 

2. 1.7. 1.8  Build_Vehicle_Status 

Build_Vehicle_Status  fills  in  the  VehicleStatusVariant  with  information  about  the  specified 
vehicle  and  returns  the  size  of  the  constructed  PDU.  dPDU  is  a  DataCollectionPDU 
containing  a  target  VehicleStatusVariant.  vehiclelD  specifies  the  MCC  vehicle  on  which 
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information  has  been  requested.  If  status  information  cannot  be  found  on  the  target 
vehicle,  an  error  is  flagged.  The  function  call  is  Build_Vehicle_Status(dPDU,  vehiclelD). 
Table  2.1-117  describes  the  parameters  used,  errors  returned  and  functions  called  using 
this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dPDU 

pointer  to  DataCollectionPDU 

/simnet/common/include/prot 
ocol/p  data.h 

vehiclelD 

pointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

vsPDU 

VehicleStatusVariant 

/simnet/common/include/prot 
ocol/p  data.h 

vehicleStatus 

pointer  to  VehicleStatus 

/simnet/common/include/prot 

ocol/status.h 

unit 

pointer  to  OrganizationalUnit 

/simnet/common/include/prot 

ocol/basic.h 

veh 

pointer  to  VehiclelDStatus 

/simnet/mcc/include/vehjabi 

e.h 

Return  Values 

Return  Value 

Type 

Meaning 

PRO  DATA  VEHICLE  STAT 
US  SIZE(dPDU) 

int 

the  size  of  the  constructed 

PDU 

Errors 

Error  Name 

Reason  for  Error 

MCC  NO  CCV  STATUS 

No  CCV  status  for  vehicle. 

Calls 

Function 

Where  Described 

PRO  DATA  VEHICLE  STAT 
US  SIZE 

Macro  defined  in  /simnet/common/include/protocol/p_size.h 

FQueue  Retrieve 

Section  2.21.1.13.7. 

Called  By 

Function 

Where  Described 

Do  Generic  StatusQuery 

Section  2. 1.7. 1.9. 

Table  2.1-117:  Bulld_Vehicle_Status  Information. 


2. 1.7. 1.9  DoGenericStatusQuery 

Do_Generic_StatusQuery  determines  if  the  Status  Query  should  be  done.  sPDU  is  a 
StatusQuery  Variant  which  describes  a  kind  of  query  which  has  been  requested  by  a  remote 
simulator.  dPDU  is  a  DataCollectionPDU,  part  of  which  may  or  may  not  be  filled  in  by  a 
specific  status-filling  routine.  dSize  is  a  pointer  to  the  size  of  the  DataCollection  PDU, 
which  is  set  to  the  size  of  the  DataCollection  PDU  if  it  is  filled  in.  exercise  is  the  number  of 
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the  exercize  in  which  the  MCC  is  running.  The  function  call  is 
Do_Generic_StatusQuery(sPDU,  dPDU,  dSize,  exercise).  Table  2.1-1 18  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

SPDU 

pointer  to  StatusQueryVariant 

/simnet/common/include/prot 
ocol/p  data.h 

dPDU 

pointer  to  DataCollectionPDU 

/simnet/common/include/prot 
ocol/p  data.h 

dSize 

pointer  to  int 

Standard  C  type. 

exercise 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

Query  ignored. 

1 

int 

Query  done. 

Calls 

Function 

Where  Described 

IqnoreStatusQuerv 

Section  2. 1.7. 1.5. 

Build  Exercise  Status 

Section  2. 1.7.1. 6. 

Build  Simulation  Status 

Section  2. 1.7.1. 7. 

Build  Vehicle  Status 

Section  2. 1.7.1. 8. 

Called  Bv 

Function 

Where  Described 

ProcessStatusQueryDataqram 

Section  2.1.7.1.10. 

ProcessStatusQueryTransacti 

on 

Section  2.1.7.1.11. 

Table  2.1-118:  Do_Genenc_StatusQuery  Information. 


2.1.7.1.10  ProcessStatusQueryDatagram 

ProcessStatusQuery Datagram  calls  Do_GenericStatusQuery()  to  determine  whether  a 
response  is  warranted,  and  to  build  the  appropriate  Status  PDU.  If  required,  the 
DataCoUectionPDU  is  sent  out  on  the  network.  PDU  is  a  DataCollectionPDU  containing  a 
StatusQuery  Variant  which  may  specify  a  query  to  which  this  MCC  must  respond.  The 
function  call  is  ProccssStatusQueryDatagram(PDU).  Table  2.1-1 19  describes  the 
parameters  used,  errors  returned  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

PDU 

pointer  to  DataCollectionPDU 

/simnet/common/include/prot 
ocol/p  data.h 

BBN  Systems  and  Technologies 


Variable 


SPDU 


dSize 


status 


Internal  Variables 


e 


MCC  CSCI 


Where  Tvbedef  Declared 


pointer  to  StatusQueryVariant  /simnet/common/include/prot 

ocol/p  data.h 


DataCollectionPDU 


/simnet/common/include/prot 
ocol/p  data.h 


Standard  C  type. 


Standard  C  type. 


Error  Name 


MCC  ASSOC  SNDDGRAM 


Errors 


Reason  for  Error 


Cannot  access  the  network 


Function 


Do  Generic  StatusQuer 


AssocSendDataaram 


AssocError 


Calls 


Where  Described 


Section  2. 1.7. 1.9. 


Section  2.20.1.2.1. 


Section  2.20.1.10.1. 


Called  B 


Function 

Where  Described 

ProcessDatColDataaram 

Section  2. 1.6. 2.2. 

Table  2.1-119:  ProcessStatusQueryDatagram  Information. 
2.1.7.1.11  ProcessStatusQueryTransaction 

ProcessStatusQueryTransaction  is  equivalent  to  ProcessStatusQueryDatagram  except  that  it 
sends  the  StatusQuery  generated  by  Do_Generic_StatusQuery  back  to  the  requesting 
simulator  as  a  transaction.  The  additional  parameters  are  Originator,  which  specifies  the 
Simulation  Address  of  the  requesting  simulator,  and  Trans  JD,  which  identifies  this 
particular  transaction.  An  error  is  signalled  in  the  case  that  hbassoc  cannot  access  the 
network.  The  function  call  is  ProcessStatusQueryTransaction(PDU,  Originator, 
Trans_ID).  Table  2.1-120  describes  the  parameters  used,  errors  returned  and  functions 
called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

PDU 

pointer  to  DataCollectionPDU 

/simnet/common/include/prot 
ocol/p  data.h 

Originator 

pointer  to  Simulation  Address 

/simnet/common/include/prot 

ocol/address.h 

TransJD 

Transaction  Identifier 

/simnet/common/include/prot 

ocol/address.h 
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Variable 


SPDU 


responsePDU 


dSize 


status 


Internal  Variables 


e 


pointer  to  StatusQueryVariant 


DataCollectionPDU 


pointer  to 

StatusResponseVariant 


int 


int 


Where  Typedef  Declared 


/simnet/common/include/prot 
ocol/D  data.h 


/simnet/common/include/prot 
ocol/D  data.h 


/simnet/common/include/prot 
ocol/p  data.h 


Standard  C  type. 


Standard  C  type. 


Error  Name 


MCC  ASSOC  SNDDGRAM 


Errors 


Reason  for  Error 


Cannot  access  the  network. 


Function 


Do  Generic  StatusQuer 


AssocSendResDonse 


AssocError 


Calls 


Where  Described 


Section  2. 1.7. 1.9. 


Section  2.20.1.4.2. 


Section  2.20.1.10.1. 


Function 


ProcessDatColTransaction 


Called  B 


Where  Described 


Section  2. 1.6. 2.3. 


Table  2.1-120:  ProcessStatusQueryTransaction  Information. 

2. 1.7. 2  vtimeout.c 

/sininet/mcc/Mother/vtimeout.c 

vtimeout.c  contains  a  routine  to  timeout  vehicle  appearance  packets. 

2 . 1 . 7 . 2 . 1  VTimeoutAppearanceTimeout 

VTimeout_Appearance_Timeout  iterates  through  all  of  the  vehicle  appearance  packets  and 
checks  to  see  if  any  of  them  have  timed  out.  Since  the  appearance  packets  are  in  a  linked 
list,  an  appearance  packet  can  not  be  deallocated  until  the  next  one  is  fetched.  If  an 
appearance  packet  is  to  be  deallocated,  it  is  first  checked  to  see  if  it  belongs  to  one  of  our 
simulators.  If  it  does,  a  copy  is  kept  to  allow  for  reconstitution.  The  function  call  is 
VTimeout_Appearance_Timeout().  Table  2.1-121  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

vlist  ptr 

pointer  to  FQueue  t 

/simnet/mcc/libmcc/fqueue.h 

deletePDU 

register  pointer  to 

Vehicle  AppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

vaPDU 

register  pointer  to 

Vehicle  AppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

Sim 

pointer  to  SimulatorStatus 

/simnet/mcc/include/veh_tabl 

e.h 

VehiclelDToSimO 

function  that  returns  a  pointer 
to  SimulatorStatus 

See  vehicle.c  in  .Section 

2. 1.1.5. 
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Return  Values 

Return  Value 

Type 

Meaning 

protocolVehicleDisappearanc 
eTime  1000 

int 

Calls 

Function 

Where  Described 

FQueue  Scan 

Section  2.21.1.13.6. 

VehiclelDToSim 

Section  2. 1.1 .5.3. 

FQueue  Remove 

Section  2.21.1.13.5. 

Table  2.1-121:  VTiineout_Appearance_Timeout  Information. 


2.1.8  Minefield  Simulation 

If  a  minefield  has  been  emplaced  by  this  MCC,  this  CSC  is  responsible  for  periodically 
sending  out  MarkerPDU's  which  describe  where  minefield  flags  are  located.  It  also  sends 
out  MinefieldPDU's  that  describe  where  a  minefield  is  located  for  data  collection  purposes. 
In  addition,  it  listens  periodically  to  see  if  a  ground  vehicle  has  crossed  into  a  minefield  and 
should  be  blown  up.  It  issues  an  impact  PDU  if  this  is  the  case.  It  also  listens  to 
BreachedLanePDUs  to  update  any  cleared  areas  which  might  intersect  this  MCC's 
minefields.  The  following  CSUs  form  its  structure: 

£  eom>  try.c 
771  iv  6 jr*  c 
minefield.c 


2. 1.8.1  geometry.c 

/simnet/mcc/Mother/geometry.c 

geometry.c  contains  routines  for  basic  geometry  utilities. 

2. 1.8. 1.1  line_crosses_rect 

line_crosses_rect  determines  if  a  line  segment  crosses  a  given  rectangle,  pos  and  dest  are 
pointers  to  two  floats  which  represent  two  (x,y)  coordinate  pairs,  rect _ptr  is  a  pointer  to  a 
rectangle  or  four  (x,y)  coordinate  pairs.  The  line  segment  crossing  the  rectangle  is  defined 
by  a  line  going  from  pos  to  dest.  The  function  call  is  line_crosses_rect(pos,  dest,  rect_ptr) 
Table  2.1-122  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

pos 

pointer  to  REAL 

/simnet/common/include/glob 
ai/sim  types. h. 

dest 

pointer  to  REAL 

/simnet/common/include/glob 
al/sim  types. h. 

rect_ptr 

pointer  to  RECT 

/simnet/mcc/Mother/geometry 

.h 

1  1 
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1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

slope 

REAL 

/simnet/common/include/glob 
al/sim  types. h. 

dx 

REAL 

/simnet/common/include/glob 
al/sim  types. h. 

dy 

REAL 

/simnet/common/include/glob 
al/sim  types. h. 

y_int 

REAL 

/simnet/common/include/glob 
al/sim  types. h. 

IJnt 

REAL 

/simnet/common/include/glob 
al/sim  types. h. 

tjnt 

REAL 

/simnet/common/include/glob 
al/sim  types.h. 

rjnt 

REAL 

/simnet/common/include/glob 
al/sim  types.h. 

bjnt 

REAL 

/simnet/common/include/glob 
al/sim  types.h. 

left 

REAL 

/simnet/common/include/glob 
al/sim  types.h. 

top 

REAL 

/simnet/common/include/glob 
al/sim  types.h. 

right 

REAL 

/simnet/common/include/glob 
al/sim  types.h. 

bottom 

REAL 

/simnet/common/include/glob 
al/sim  types.h. 

path_rect 

RECT 

/simnet/mcc/Mother/geometry 

.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

TRUE 

int 

Line  intersects  rectangle. 

FALSE 

int 

Line  does  not  intersect 
rectangle. 

1  Calls  1 

Function 

Where  Described 

intersect  rect 

Section  2. 1.8. 1.2. 

Table  2.1-122;  line  crosses  rect  Information. 


2. 1.8. 1.2  intersect  rect 


intersect_rect  determines  if  two  rectangles,  rl  and  r2,  intersect.  The  function  call  is 
intersect_rect(rl ,  r2).  Table  2.1-123  describes  the  parameters  used  by  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

n 

pointer  to  RECT 

/simnet/mcc/Mother/geometry 

.h 

r2 

pointer  to  RECT 

/simnet/mcc/Mother/geometry 

.h 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

intersect 

RECT 

/simnet/mcc/Mother/geometry 

.h 

Return  Values 

Return  Value 

Type 

Meaning 

TRUE 

int 

Rectangles  intersect. 

FALSE 

int 

Rectangles  don’t  intersect. 

Called  By 

Function 

Where  Described 

line  crosses  rect 

Section  2. 1.8. 1.1. 

Table  2.1-123:  intersect  rect  Information. 


2. 1.8. 1.3  init  rect 


init_rect  initializes  a  rectangle,  specified  by  rect  j)tr.  The  function  call  is  init_rect(rect_ptr). 
Table  2.1-124  describes  the  parameters  used  by  this  function. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

rect_ptr 

pointer  to  RECT 

/simnet/mcc/Mother/geometry 

.h 

Table  2.1-124;  init  rect  Information. 


2. 1.8. 1.4  inflate  rect 


inflate_rect  expands  a  rectangle,  rect _ptr,  by  amount  in  all  directions.  The  function  call  is 
inflate_rect(rect_ptr,  amount).  Table  2.1-125  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

rect_ptr 

pointer  to  RECT 

/simnet/mcc/Mother/geometry 

.h 

amount 

REAL 

/simnet/common/include/glob 
al/sim  types. h. 

Table  2.1-125;  inflate_rect  Information. 


2. 1.8. 1.5  make_polygon 

make_polygon  creates  a  polygon,  nwn  vertices  is  the  number  of  vertices  in  the  polygon  to 
be  created,  array _rep  is  a  list  of  vertices  which  will  be  in  the  polygon,  poly  rep  the 
polygon  structure  created  and  passed  back  to  the  user.  The  function  call  is 
make_polygon{num_venices,  array_rep,  poly_rep).  Table  2.1-126  describes  the 
parameters  used  by  this  function. 
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Parameters 

Parameter 

Tvbe 

Where  Tvoedef  Declared 

num  vertices 

int 

Standard  C  type. 

array  repfMAXPOLYGON  VE 
RTICESir21 

register  matrix  of  REAL 

/simnet/common/include/glob 
al/sim  types. h. 

poly_rep 

register  pointer  to  POLYGON 

/simnet/mcc/Mother/geometry 

.h 

Variable 


left 


right 


top 


bottom 


Internal  Variables 


e 


int 


register  REAL 


register  REAL 


REAL 


REAL 


REAL 


REAL 


Where  Tvoedef  Declared 


Standard  C  type. 


/simnet/common/include/glob 
al/sim  types. h. 


/simnet/common/include/glob 
al/sim  types. h. 


/simnet/common/include/glob 
al/sim  types. h. 


/simnet/common/include/glob 
al/sim  types. h. 


/simnet/common/include/glob 
al/sim  types. h. 


/simnet/common/include/glob 
al/sim  types. h. 


Called  B 


Function 

Where  Described 

Emplace  Generic 

Section  2. 1.8.3. 6. 

Table  2.1-126:  make_po!ygon  Information. 

2. 1.8. 1.6  point_in_poIygon 

point_in_polygon  determines  if  point  is  in  polygon.  The  function  call  is 
point_in_poIygon(point,  polygon).  Table  2.1-127  describes  the  parameters  used  and 
functions  call^  using  this  function. 


Parameter 


point 


polygon 


Parameters 


Where  Typedef  Declared 


/simnet/common/include/glob 
al/sim  types. h. 


register  pointer  to  POLYGON  /simnet/mcc/Mother/geometry 

.h 


register  pointer  to  REAL 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

register  int 

Standard  C  type. 

num  crossed 

int 

Standard  C  type. 

xO 

register  int 

Standard  C  type. 

vO 

register  int 

Standard  C  type. 

x1 

register  int 

Standard  C  type. 

V1 

register  int 

Standard  C  type. 

m 

register  REAL 

/simnet/common/include/glob 
al/sim  types. h. 

b 

register  REAL 

/simnet/common/include/glob 
al/sim  types. h. 

Return  Values 

Return  Value 

Type 

Meaning 

FALSE 

int 

Point  not  in  polygon. 

num_crossed 

int 

Number  of  polygon  line 
segment  crossed  going  from 
point  to  infinity.  An  odd 
number  means  that  we  are 
within  the  polygon. 

Calls 

Function 

Where  Described 

point  in  red 

Macro  defined  in  /simnet/mcc/Mother/geometrv.h. 

Called  Bv 

Function 

Where  Described 

Mines  Point  In  Minefield 

Section  2.1.8.3.13. 

Table  2.1-127:  point_in_polygon  Information. 

2. 1.8. 2  marker.c 

/simnet/mcc/Mother/marker.c 

marker.c  handles  the  maintainance  and  processing  of  minefield  markers.  Table  2.1-128 
shows  some  of  the  variables  used  by  marker.c. 
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1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

networklnterface 

extern  int 

/simnet/mcc/include/MCC_net 

.h 

markerLineTable 

array  MAX_MARKER_LINES 
of  MarkerLine 

/simnet/mcc/Mother/marker.c 

maBuf 

SimulationPDU 

/simnet/common/include/prot 
ocol/D  sim.h 

currentBatch 

int 

Standard  C  type. 

currentPDU 

int 

Standard  C  type. 

currentLine 

int 

Standard  C  type. 

currentMarker 

int 

Standard  C  type. 

retrvPDUCount 

int 

Standard  C  type. 

markerInPDU 

int 

Standard  C  type. 

nextLineIndex 

int 

Standard  C  type. 

nextMarkerlD 

int 

Standard  C  type. 

Table  2.1-128:  marker.c  Variable  Information. 


2 . 1 . 8 . 2 . 1  Marker_EmpIace_Minefield 

Marker_Emplace_Minefield  creates  the  required  lines  of  minefield  markers  which  should  be 
used  to  mark  that  minefield  from  the  passed  Minefield  emplacement  message,  vertices  is  a 
pointer  to  a  list  of  (x,y)  coordinate  pairs  which  defined  the  edges  of  a  minefield  somewhere 
on  the  terrain,  vertexjcount  is  the  number  of  vertices  pointed  to  by  vertices.  The  function 
call  is  Marker_Emplace_Minefield(vertices,  venex_count).  Table  2.1-129  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters 

Parameter 

Type 

Where  Typedef  Declared 

yertices 

pointer  to  LongPt 

/simnet/common/include/glob 

al/lonqpt.h 

yertex_count 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

startPt 

int 

Standard  C  type. 

endPt 

int 

Standard  C  type. 

dx 

double 

Standard  C  type. 

dy 

double 

Standard  C  type. 

marker  azimuth 

double 

Standard  C  type. 

Calls 

Function 

Where  Described 

radians  to  simnet  anqie 

libapp.h 

Marker  Add  Line 

Section  2. 1.8. 2. 2. 

Called  By 

Function 

Where  Described 

EmplaceRequesl 

Section  2. 1.1. 2. 2. 

Table  2.1-129:  Marker_Emplace_Minefield  Information. 
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2. 1.8. 2. 2  Marker  Add  Line 


Marker_Add_Line  creates  a  line  of  markers,  type  determines  the  type  of  the  marker,  either 
MIisEFIELD_MARKER  or  BREACH_MARK£R.  spacing  is  the  amount  of  space,  in 
meters,  between  the  marker  flags,  start  is  the  (x,y)  coordinate  defining  the  start  of  the  line 
of  flags  and  end  is  the  coordinate  pair  for  the  end  of  the  line  of  flags,  marker  azimuth 
defines  the  angle  of  the  marker  flag  ins  SIMNET  BAM  (Binary  Angle  Measure)  units  from 
North  (0).  The  function  call  is  Marker_Add_Line(type,  spacing,  start,  end, 
marker_azimuth).  Table  2. 1-130  describes  the  parameters  used  and  functions  called  using 
this  function. 


1  Parameters  | 

1  Parameter 

Type 

Where  Typedef  Declared 

int 

Standard  C  type. 

spacinq 

int 

Standard  C  type. 

start 

pointer  to  LongPt 

/simnet/common/include/glob 

al/longpt.h 

end 

pointer  to  LongPt 

/simnet/common/include/glob 

al/longpt.h 

marker_azimuth 

Angle 

/simnet/common/include/prot 

ocol/basic.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

markerLine 

pointer  to  MarkerLine 

/simnet/mcc/Mother/marker.c 

diffX 

long 

Standard  C  type. 

diffY 

long 

Standard  C  type. 

deltaX 

int 

Standard  C  type. 

deltaY 

int 

Standard  C  type. 

length 

int 

Standard  C  type. 

potentialMarkers 

int 

Standard  C  type. 

testLocation 

array  2  of  float 

Standard  C  type. 

testMarker 

int 

Standard  C  type. 

realMarker 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

Marker  Get  Next  Marker 

Section  2. 1.8. 2.4. 

SQR 

Macro  defined  in  /simnet/mcc/Mother/marker.c. 

Marker  Point  In  Terrain 

Section  2. 1.8. 2.5. 

tdb  qet  z 

Section  2.21.7.16.2. 

tdb  error 

Section  2.21.7.17.1. 

1  Called  By  I 

Function 

Where  Described 

BreachRequest 

Section  2. 1.1. 2.3. 

Marker  Emplace  Minefield 

Section  2.1. 8.2.1. 

Table  2.1-130:  Marker  Add  Line  Information. 
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2 . 1 . 8 . 2 . 3  Marker_Broadcast_Markers 

Marker_Broadcast_Markers  broadcasts  Marker  “Appearance”  PDUs  for  the  maintained 
markers.  It  returns  the  interval  to  wait  before  calling  the  procedure  again.  The  function  call 
is  Marker_Broadcast_Markers().  Table  2.1-131  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

maPDU 

pointer  to  MarkerVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

temp 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

temp 

int 

Period  to  wait  before  calling 
procedure  again. 

markerBatchPeriod 

int 

Constant  defined  in 
/simnet/mcc/include/MCCjim 
ers.h.  Period  to  wait  before 
callinq  procedure  again. 

Function _ 

AssocSendPataqram 
PRO  SIM  MARKER  SIZE 

AssocError _ 

MAX 


_ Calls _ 

Where  Described _ 

Section  2.20.1 .2.1 . _ 

Macro  defined  in  /simnet/common/include/protocol/p  size.h 

Section  2.20.1.10.1 , _ 

Macro  defined  in  /simnet/mcc/Mother/marker.c. _ 


Table  2.1-131:  Marker_Broadcast_Markers  Information. 
2. 1.8. 2. 4  Marker  Get  Next  Marker 


Marker_Get_Next_Marker  returns  a  pointer  to  an  available  MarkerLine  structure.  The 
function  call  is  Marker_Get_Next_Marker().  Table  2.1-132  describes  the  return  values 
generated  by  this  function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

pointer  to  MarkerLine 

No  MarkerLine  structure 
available. 

&markerLineTable[nextLineln 

dex++l 

pointer  to  MarkerLine 

Next  MarkerLine  structure 
available. 

Called  By 

Function 

Where  Described 

Marker  Add  Line 

Section  2. 1.8. 2.2. 

Table  2.1-132:  Marker  Get  Next  Marker  Information. 
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2. 1.8. 2. 5  Marker  Point  In  Terrain 


Marker_Point_In_Terram  tests  to  see  if  location  is  on  the  terrain.  The  function  call  is 
Marker_Point_In_Terrain(location).  Table  2.1-133  describes  the  parameters  used  by  this 
function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

location 

pointer  to  float 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

Point  not  on  terrain. 

1 

int 

Point  on  terrain. 

Called  By 

Function 

Where  Described 

Marker  Add  Line 

Section  2. 1.8. 2. 2. 

Table  2.1-133:  Marker  Point  In  Terrain  Information. 


2. 1.8. 3  minefield. c 

/simnet/mccAlother/minerield.c 


minefield.c  does  the  processing  to  check  for  simulators  blowing  up  in  minefields. 
Currently,  only  ground  vehicles  are  affected.  Table  2.1-134  shows  some  variables  used  by 
minefield.c. 


I  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

Minefields 

array  MAX_MINEFIELDS  of 
Minefield  t 

/simnet/mcc/Mother/minefield. 

h 

Minefield  Object  Counter 

unsigned  short 

Standard  C  type. 

Minefield  Event 

unsigned  long 

Standard  C  type. 

VAPDU  Ptr 

pointer  to  FQueue  t 

/simnet/mcc/libmcc/fgueue.h 

networkinterface 

extern  int 

Standard  C  type. 

Table  2.1-134:  minefield.c  Variable  Information. 
2. 1.8. 3.1  Current  Minefield  Count 


Current_Minefield_Count  returns  the  number  of  minefields  currently  in  use.  The  function 
call  is  Current_Minefield_Count().  Table  2.1-135  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

register  int 

Standard  C  type. 

mcount 

register  int 

Standard  C  type. 

I  I 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

mcount 

unsigned  char 

Number  of  minefields  in  use. 

Calls 

Function 

Where  Described 

Mines  Max  Minefields 

Section  2.1. 8.3.4. 

Called  By 

Function 

Where  Described 

Emplace  Generic 

Section  2.1. 8.3.6. 

Mines  Point  In  Minefield 

Section  2.1.8.3.13. 

Table  2.1-135;  Current_Minef1eId_Count  Information. 


2. 1.8. 3. 2  AlIoc_MinefieId 

Alloc_Minefield  allocates  a  pointer  to  an  available  Minefield  struc'  ire.  The  function  call  is 
Alloc_Minefield().  Table  2.1-136  describes  the  internal  variable  i,  ed  and  functions  called 
using  this  function. 


Variable 


IGCTT 


Internal  Variables 


e 


Where  Tvpedef  Declared 


Standard  C  tvpe. 


Return  Value 


NULL 


&Minefields[i] 


Return  Values 


Type 


pointer  to  MinefieldJ 


pointer  to  MinefieldJ 


Meaning 


No  minefields  available. 


Next  available  minefield. 


Function 


Mines  Max  Minefields 


Calls 


Where  Described 


Section  2. 1.8.3. 4. 


Called  B 


Function 

Where  Described 

Emplace  Generic 

Section  2.1. 8.3.6. 

Table  2.1-136:  Alloc  Minefield  Information. 


2. 1.8. 3. 3  Free  Minefield 


Free_Minefield  frees  a  minefield.  Minefield  from  use.  The  function  call  is 
Free_Minefield(Minefield).  Table  2.1-137  describes  the  parameters  used  by  this  function. 

_ Parameters _ 

Parameter  Type  Where  Typedef  Declared 

Minefield  pointer  to  MinefieldJ  /simnet/mcc/Mofher/minefield. 

h 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

short 

Always  returned. 

Table  2.1-137:  Free  Minefield  Information. 


2. 1.8. 3. 4  Mines_Max_Minefields 

Mines_Max_Minefields  returns  the  maximum  number  of  minefields  allowed.  The  function 
call  is  Mines_Max_Minefields().  Table  2.1-138  describes  the  return  value  generated  by 
this  function. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

MAX_MINEFIELDS 

unsigned  char 

Maximum  number  of 
minefields  allowed. 
MAX_MINEFIELDS  is  a 
constant  defined  in 
minefield.c 

Called  By  1 

Function 

Where  Described 

Current  Minefield  Count 

Section  2. 1.8. 3.1. 

Alloc  Minefield 

Section  2. 1,8. 3.2. 

Emplace  Generic 

Section  2.1. 8.3.6. 

Mines_Process_Breach_Data 

qram 

Section  2.1.8.3.10. 

Table  2.1-138:  Mines  Max  Minefields  Information. 


2. 1.8. 3. 5  Mines  Max  Vertices 


Mines_Max_Vertices  returns  the  maximum  number  of  vertices  for  a  minefield.  The 
function  call  is  Mines_Max_Vertices().  Table  2.1-139  describes  the  return  value  generated 
by  this  function. 


1  Return  Values  I 

Return  Value 

Type 

Meaning 

MAX_VERTICES 

unsigned  char 

Maximum  number  of  vertices 
allowed.  MAX_VERTICES  is  a 
constant  defined  in 
minefield.c 

Called  By 

Function 

Where  Described 

Make  Minefield  Status 

Section  2.1.8.3.17. 

Table  2.1-139:  Mines  Max  Vertices  Information. 
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2. 1.8. 3. 6  Einplace_Generic 

Emplace_Generic  creates  a  minefield  structure.  Vertices  is  a  list  of  (x,y)  coordinate  pairs 
defining  the  edges  of  the  minefield/breach  lane  to  be  emplaced.  VertexjCount  is  the 
number  of  coordinate  pairs  in  Vertices.  Type  describes  whether  the  area  is  a  breach  lane  or 
a  minefield.  The  function  call  is  Emplace_Generic(Venices,  Vertex_Count,  Type).  Table 
2.1-140  describes  the  parameters  us^  and  functions  called  using  this  function. 


Parameters 


Parameter 


Vertices 


Vertex  Count 


Type 


Variable 


minefield 


Return  Value 


NULL 


minefield 


array  of  LongPt 


unsianed  char 


u  short 


Where  Tvoedef  Declared 


/simnet/common/include/glob 

al/lonapt.h 


Standard  C  tvoe. 


Internal  Variables 


e 


pointer  to  MinefieldJ 


1 1  by  2  matrix  of  double 


Where  Tvpedef  Declared 


Standard  C  type. 


/simnet/mcc/Mother/minefield. 

h 


Standard  C  type. 


Return  Values 


Type 


pointer  to  MinefieldJ 


pointer  to  Minefield t 


Meaning 


Minefield  not  emplaced. 


Minefield  emplaced. 


Function 


Current  Minefield  Count 


Mines  Max  Minefields 


Alloc  Minefield 


make  polyoon 


Calls 


Where  Described 


Section  2.1. 8.3.1. 


Section  2.1. 8.3.4. 


Section  2.1. 8.3.2. 


Section  2. 1.8. 1.5. 


Function 


Mines  Emplace  Minefield 


Mines  Breach  Lane 


Called  B 


Where  Described 


Section  2. 1.8. 3.7. 


Section  2.1. 8.3.8. 


Table  2.1-140:  EmpIace  Generic  Information. 

2.1 .8.3.7  Mines_Emplace_Minefield 

Mines_Emplace_Minefield  creates  a  minefield  structure  by  calling  Emplace_Generic  and 
assigns  mine  densities.  Vertices  is  a  list  of  (x,y)  coordinate  pairs  defining  the  edges  of  the 
minefield  lane  to  be  emplaced.  Vertex  Count  is  the  number  of  coordinate  pairs  in  Vertices. 
ATDensity  is  the  density  of  Anti_Tank  Mines,  APFDensity  is  the  density  of 
AntLPersonnel  fragmenting  mines  and  APBDensity  is  the  density  of  Anti_Personnel  blast 
mines.  All  mine  densities  are  given  in  mines  per  square  meter.  The  function  call  is 
Mines_Emplace_Minefield(Vertices,  Vertex_Count,  ATDensity,  APFDensity, 
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APBDensity).  Table  2.1-141  describes  the  parameters  used  and  functions  called  using  this 
function. 


Parameters 


Parameter 


vertices 


Vertex  Count 


APFDensit 


APBDensit 


array  of  LongPt 


unsioned  char 


float 


float 


float 


Where  TvDedef  Declared 


/simnet/common/include/glob 

al/lonopt.h 


Standard  C  tvoe. 


Standard  C  tvoe. 


Standard  C  type. 


Standard  C  type. 


Variable 


minefield 


Internal  Variables 


e 


pointer  to  Minefields 


Where  Tvoedef  Declared 


/simnet/mcc/Mother/minefield. 

h 


Return  Value 


-1 


0 


Return  Values 


Type 


int 


int 


Meaning  _ 


Minefield  not  emplaced. 


Minefield  emplaced. 


Function 


Emplace  Generic 


Calls 


Where  Described 


Section  2. 1.8.3. 6. 


Called  B 


Function 

Where  Described 

EmplaceRequest 

Section  2. 1.1. 2. 2. 

Table  2.1-141:  Mines_Emplace_MinefieId  Information. 
2. 1.8. 3. 8  Mines  Breach  Lane 


Mines_Breach_Lane  allocates  a  breached  lane.  Vertices  is  a  list  of  (x,y)  coordinate  pairs 
defining  the  edges  of  the  breach  lane.  Vertex  Count  is  the  number  of  coordinate  pairs  in 
Vertices.  If  Breach  JD  is  NULL,  then  the  ID  that  was  allocated  by  Emplace_Generic  is  left 
in.  Otherwise  the  ID  that  was  passed  in  is  used;  in  this  case,  the  ID  is  from  some  other 
system  which  just  breached  an  area  and  notified  us  over  the  network.  The  function  call  is 
Mines_Breach_Lane(Venices,  Vertex_Count,  Breach_ID).  Table  2.1-142  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Vertices 

array  of  LongPt 

/simnet/common/include/glob 

al/longpt.h 

Vertex  Count 

unsigned  char 

Standard  C  type. 

Breach_ID 

Object  ID 

/simnet/common/include/prot 

ocol/basic.h 

1  1 
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Variable 


minefield 


Internal  Variables 


e 


pointer  to  Minefieldj 


Where  Tvoedef  Declared 


/simnet/mcc/Mother/minefield. 

h 


Return  Value 


NULL 


minefield 


Return  Values 


Type _ 


pointer  to  Minefieldj 


pointer  to  Minefieldj 


Meaning 


No  breach  lane  emplaced. 


Breach  lane  emplaced. 


Function 


Emplace  Generic 


Calls 


Where  Described 


Section  2. 1.8.3. 6. 


Called  B 


Function 

Where  Described 

Mines  Emplace  Breach 

Section  2.1. 8.3.9. 

Mines_Process_Breach_Data 

gram 

Section  2.1.8.3.10. 

Table  2.1-142:  Mines_Breach_Lane  Information. 

2. 1.8. 3. 9  Mines_Emplace_Breach 

Mines_Emplace_Breach  emplaces  a  breach  lane  into  some  area  on  the  terrain  database  and 
indicates  to  the  rest  of  the  network  that  this  has  occured.  Vertices  is  a  list  of  (x,y) 
coordinate  pairs  definii.g  the  edges  of  the  breach  lane  to  be  emplaced  and  Vertex_count  is 
the  number  of  coordinate  pairs  in  Vertices.  The  function  call  is 

Mines_Emplace_Breach(Vertices,  Vertex_Count).  Table  2.1-143  describes  the  parameters 
used  and  functions  called  using  this  function. 


Parameters 


Parameter 


Vertices 


Vertex  Count 


array  of  LongPt 


unsioned  char 


Where  Tvpedef  Declared 


/simnet/common/include/glob 

al/lonqpt.h 


Standard  C  type. 


Internal  Variables 

Variable 

Where  Tvpedef  Declared 

minefield 

pointer  to  Minefieldj 

/simnet/mcc/Mother/minefield. 

h 

simPDU 

SimulationPDU 

/simnet/common/include/prot 
ocol/p  sim.h 

breach 

pointer  to 

BreachedLaneVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

Standard  C  type. 


Return  Values 


Return  Value 


-1 


0 


Type 


int 


int 


Meaning 


Unsuccessful. 


Successful. 
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1  Calls  1 

Function 

Where  Described 

Mines  Breach  Lane 

Section  2.1. 8.3.8. 

AssocSendDatapram 

Section  2.20.1.2.1. 

AssocError 

Section  2.20.1.10.1. 

Called  Bv 

Function 

Where  Described 

BreachRequest 

Section  2.1. 1.2.3. 

Table  2.1-143:  Mines_Emplace_Breach  Information 


2.1.8.3.10  Mines_Process_Breach_Datagram 

Mines_Process_Breach_Datagram  is  called  when  a  breach  lane  status  packet,  simPDU,  is 
received.  If  this  breach  lane  is  not  yet  recorded,  it  will  be  recorded  at  this  time.  The 
function  call  is  Mines_Process_Breach_Datagram(simPDU).  Table  2.1-144  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Tvoe 

Where  Typedef  Declared 

SimPDU 

pointer  to  SimulationPDU 

/simnet/common/include/prot 
ocol/p  sim.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

breach 

pointer  to 

BreachedLaneVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

Vertices 

array  MAX_VERTICES  of 
LonqPt 

/simnet/common/include.'glob 

al/lonqpt.h 

Vertex  Count 


Standard  C  type. 


Standard  C  type. 


Function 


Mines  Max  Minefields 


Mines  Breach  Lane 


Calls 


Where  Described 


Section  2.1. 8.3.4. 


Section  2.1. 8.3.8. 


Function 


ProcessSirnDataoram 


Called  B 


Where  Described 


Section  2.1. 6.2.9. 


Table  2.1-144:  Mines_Process_Breach_Datagram  Information. 
2.1.8.3.11  Mines_Get_Info 

Mines_Get_Info  allows  queries  to  be  made  about  what  minefields  and  breach  lanes  are 
currently  emplaced.  This  is  needed  for  the  MCC  console  to  be  able  to  restart  after  it  has 
crashed.  This  routine  should  be  invoked  iteratively  in  order  to  get  information  on 
subsequent  minefields.  Context  contains  the  number  of  minefields  last  used  when  this 
routine  was  called.  The  first  time  the  routine  is  called,  this  should  be  zero.  Vertices  is  a  list 
of  (x.y)  coordinate  pairs  defining  the  edges  of  the  next  minefield  lane.  Vertex  Count  is  the 
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number  of  coordinate  pairs  in  Vertices.  ATDensity  is  the  density  of  Anti_Tank  Mines, 
APFDensity  is  the  density  of  Anti_Personnel  fragmenting  mines  and  APBDensity  is  the 
density  of  Anti_Personnel  blast  mines.  All  mine  densities  are  given  in  mines  per  square 
meter.  The  function  call  is  Mines_Get_Info(Context,  Vertices,  Venex_Count,  ATDensity, 
APFDensity,  APBDensity).  Table  2.1-145  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

Context 

pointer  to 

Minefield  Context  t 

/simnet/mcc/Mother/minefield. 

h 

Vertices 

array  of  LongPt 

/simnet/common/include/glob 

al/lonqpt.h 

Vertex  Count 

unsigned  char 

Standard  C  type. 

pointer  to  float 

Standard  C  type. 

APFDensity 

pointer  to  float 

Standard  C  type. 

APBDensity 

pointer  to  float 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

minefield 

pointer  to  Minefield_t 

/simnet/mcc/Mother/minefield. 

h 

i 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

No  active  minefields. 

-1 

int 

Successful. 

Table  2.1-145:  Mines_Get_Info  Information. 

2.1.8.3.12  BIow_VehicIe 

Blow_Vehicle  creates  a  SimulationPDU,  vaPDU,  when  a  vehicle  is  blown  up  by  a  mine, 
determined  by  minefield  and  munition.  The  function  call  is  Blow_Vehicle(vaPDU, 
minefield,  munition).  Table  2.1-146  describes  the  parameters  used  and  functions  called 
using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

vaPDU 

pointer  to 

Vehicle  AppearanceVaraint 

/simnet/common/include/prot 
ocol/p  sim.h 

minefield 

pointer  to  Minefield_t 

/simnet/mcc/Mother/minefield. 

h 

munition 

ObjectType 

/simnet/common/include/prot 

ocol/basic.h 

I  I 
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Variable 


if_buf 


if_pdu 


detonation 


status 


Internal  Variables 


e 


SimulationPDU 


pointer  to  IndirectFireVariant 


pointer  to 

IndirectFireDetonation 


int 


Where  Tvoedef  Declared 


/simnet/common/include/prot 
ocol/D  sim.h 


/simnet/common/include/prot 
ocol/D  sim.h 


/simnet/common/include/prot 
ocol/D  sim.h 


Standard  C  tvDe. 


Function 


AssocSendDataoram 


PRO  SIM  IND  FIRE  SIZE 


AssocError 


Calls 


Where  Described 


Section  2.20.1.2.1. 


Macro  defined  in  /simnet/common/include/orotocol/D  size.h 


Section  2.20.1.10.1. 


Function 


Crossina  Minefield 


Called  B 


Where  Described 


Section  2.1.8.3.14. 


Table  2.1-146:  BIow_VehicIe  Information. 

2.1.8.3.13  Mines_Poin t_In_Minefield 

Mines_Point_In_Minefield  determines  if  a  point,  specified  by  x  and  y,  is  in  a  minefield. 
Note  that  the  minefields  ar''  searched  in  reverse  chronological  order.  This  algorithm  deals 
correctly  with  laying  down  multiple  minefields  and  breach  lanes  which  cover  the  same 
geographical  area.  The  function  call  is  Mines_Point_In_Minefield(x,  y).  Table  2.1-147 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


minefield  count 


location 


Parameters 


e 


double 


double 


Where  Tvpedef  Declared 


Standard  C  tyoe. 


Standard  C  tvoe. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

xed 

int 

Standard  C  type. 

int 


int 


array  2  of  double 


Standard  C  tyoe. 


Standard  C  tyoe. 


Standard  C  tyoe. 


Return  Value 


Return  Values 


Type 


int 


Meaning 


Point  not  in  minefield  or  in 
breached  lane. 


Point  in  minefield. 


Function 


Current  Minefield  Count 


oint  in  Dolyoon 


Calls 


Where  Described 


Section  2.1. 8.3.1. 


Section  2. 1.8. 1.6. 
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_ _ Called  By 

Function _ Where  Described 

Mines  Check  Minefields _ Section  2.1.8.3.15. 

FindAnOpenSpot _ Section  2.1.2.5.1. 


Table  2.1-147:  Mines_Point_In_Minefield  Information. 
2.1.8.3.14  Crossing_Minefield 

Crossing_Minefield  determines  if  a  vehicle  should  be  blown  up  given  that  it  is  in  a 
minefield.  The  chance  of  a  vehicle  being  blown  up  is  determined  by  the  number  of  mines 
that  the  vehicle  has  crossed  since  the  last  scan.  This  is  calculated  by  knowing  the  mine 
density  and  assuming  that  the  vehicle  is  moving  at  a  constant  velocity.  There  is  a  66.7% 
chance  that  the  vehicle  has  exploded  for  each  mine  it  has  crossed.  There  is  also  a  chance 
equal  to  the  density  of  the  minefield  that  the  vehicle  hit  a  mine  if  it  did  not  pass  over  any 
“probabilistic”  mines.  Otherwise,  we  would  not  blow  up  vehicles  that  moved  very  slowly. 
vaPDU  is  the  vehicle  appearance  PDU  of  the  vehicle  which  is  crossing  the  minefield. 
minefield  is  a  pointer  to  the  minefield  structure  containing  information  on  the  density  and 
types  of  mines  in  the  minefield,  vehicle _domain  is  the  vehicle  domain  bitmask  which  is 
used  to  tell  if  the  vehicle  is  affected  by  the  minefield.  The  function  call  is 
Crossing_Minefield(vaPDU,  minefield,  vehicle_domain).  Table  2.1-148  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

vaPDU 

pointer  to 

Vehicle  AppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

minefield 

pointer  to  MinefieldJ 

/simnet/mcc/Mother/minefield. 

h 

vehicle  domain 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

area  covered 

float 

Standard  C  type. 

mines  crossed 

unsigned  long 

Standard  C  type. 

i 

unsigned  int 

Standard  C  type. 

velocity 

unsigned  int 

Standard  C  type. 

delta  t 

float 

Standard  C  type. 

delta  X 

double 

Standard  C  type. 

delta  y 

double 

Standard  C  type. 

delta  z 

double 

Standard  C  type. 

Calls 

Function 

Where  Described 

EXP2 

Macro  defined  in  /simnet/mcc/Mother/minefield.c. 

Blow  Vehicle 

Section  2.1.8.3.12. 
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1  Called  By  I 

Function 

Where  Described 

Mines  Check  Minefields 

Section  2.1.8.3.15. 

Table  2.1.148:  Crossing_Minefield  Information. 

2.1.8.3.15  Mines_Check_MinefieIds 

Mines_Check_Minefields  checks  to  see  which  vehicles  are  in  minefields.  If  a  vehicle  is  in 
a  minefield,  then  further  checking  is  done  to  see  if  it  is  blown  up.  On  each  scan  through 
this  routine,  we  only  check  1/3  of  the  vehicles  unless  there  are  less  than 
PACKET_MINIMUM  (constant  defined  in  minefield.c)  vehicles.  In  that  case,  all  the 
vehicles  are  checked.  Tbe  function  call  is  Mines_Check_Minefields().  Table  2. 1- 149 
describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

vlist  ptr 

pointer  to  FQueue  t 

/simnet/mcc/libmcc/fqueue.h 

packets  inspected 

reqister  int 

Standard  C  type. 

inspect  max 

reqister  int 

Standard  C  type. 

domain 

int 

Standard  C  type. 

enviroment 

int 

Standard  C  type. 

i 

int 

Standard  C  type. 

vaPDU 

register  pointer  to 
VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

Return  Values 

Return  Value 

Type 

Meaning 

mcc->mineScanlnterval 

int 

Time  delay  before  calling 
procedure  again. 

Calls 

Function 

Where  Described 

FQueue  Scan 

Section  2.21.1.13.6. 

Mines  Point  In  Minefield 

Section  2.1.8.3.13. 

Crossinq  Minefield 

Section  2.1.8.3.14. 

Table  2.1-149:  Mines  Check  Minefields  Information. 


2.1.8.3.16  Make_Breach_Status 

Make_Breach_Status  creates  a  SimulationPDU,5/m/^D(/,  with  information  about  a 
breached  lane  in  a  minefield,  minefield.  The  function  call  is 

Make_Breach_Status(simPDU,  minefield).  Table  2.1-150  describes  the  parameters  used 
by  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

simPDU 

pointer  to  SimulationPDU 

/simnet/common/include/prot 
ocol/p  sim.h 

minefield 

pointer  to  MinefieldJ 

/simnet/mcc/Mother/minefield. 
ih _ 
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Internal  Variables 

Variable 

Where  Typedef  Declared 

br_pdu 

pointer  to 

BreachedLaneVariant 

/simnet/common/include/prot 
ocoI/D  sim.h 

i _ 

int 

Standard  C  type. 

Called  By 

Function 

Where  Described 

Mines_Send_Min3field_Statu 

s 

Section  2.1.8.3.18. 

Table  2.1-150:  Make_Breach_Status  Information. 
2.1.8.3.17  Make_Minefield_Status 

Make_Minefield_Status  creates  a  simulationPDU,  simPDU,  with  information  about  a 
minefield,  minefield.  The  function  call  is  Make_Minefield_Status(simPDU,  minefield). 
Table  2.1-151  describes  the  parameters  used  and  functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

SimPDU 

pointer  to  SimulationPDU 

/simnet/common/include/prot 
ocol/p  sim.h 

minefield 

pointer  to  MinefieldJ 

/simnet/mcc/Mother/minefield. 

h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

mf_pdu 

pointer  to  MinelieldVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

j 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

Mines  Max  Vertices 

Section  2. 1.8. 3.5. 

Called  By 

Function 

Where  Described 

Mines_Send_Minefield_Statu 

s 

Section  2.1.8.3.18. 

Table  2.1-151:  Make_Mlnefield_Status  Information. 
2.1.8.3.18  Mines_Send_Minefield_Status 

Mines_Send_Minefield_Status  sends  out  ?  status  packet  describing  each  minefield  and 
breach  lane  which  this  system  created.  The  function  call  is 

Mines_Send_Minefield_Status().  Table  2.1-152  describes  the  internal  variables  used  and 
functions  called  using  this  function. 
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1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

mf_bui 

SimulationPDU 

/simnet/common/include/prot 
ocol/D  sim.h 

i 

int 

Standard  C  type. 

status 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

30000 

int 

Calls 

Function 

Where  Described 

Make  Minefield  Status 

Section  2.1.8.3.17. 

Make  Breach  Status 

Section  2.1.8.3.16. 

AssocSendDataqram 

Section  2.20.1.2.1. 

AssocError 

Section  2.20.1.10.1. 

Table  2.1-152:  Mines  Send  MinefieId_Status  Information. 
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2.2  The  see  (SIMNET  eontrol  eonsole)  Process 

The  see  host  process  communicates  directly  with  the  SCe  Macintosh  application.  Its 
functions  include  initializing  components  of  a  simulation  exercise,  placing  combat  vehicles, 
reconstituting  vehicles,  and  placing  static  vehicles.  Its  structure  is  shown  in  Figure  2.2-1 
below. 


Initializing 

Software 

1.2.1 


-  cas.c 
1.2.1. 1 

■  css.c 
1.2.1. 2 

•  fse.c 

1.2.1. 3 

-  main.c 

1.2. 1.4 

•  terrain. c 

1.2.1. 5 

.  cew.c 

1.2.1. 6 


see  Process 
1.2 


Placing  and 
Reconstituting 
eombat 
Vehicles 

1.2.2 


I— sim.c 
1. 2.2.1 


-ccv.c 

1. 2.3.1 

.  target.c 

1. 2.3.2 


Placing  and 
Reconstituting 
Static 
Vehicles 

1.2.3 


eommunicationi 
with  World 

1.2.4 


I—  restart.c 

1. 2.4.1 

stop.c 

1. 2.4.2 


Figure  2.2-1:  SCC  (SIMNET  Control  Console)  Process  Structure. 
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The  see  process  sends  and  receives  the  interprocess  messages  listed  in  Table  2.2-1. 


Interprocess 

Message 

Received 

From 

Sent  To 

In  Response  To 

Data  Sent 

Transaction  Type 

InitTerrain 

Mother 

Exercise 

initialization 

complete 

-terrain 

database 

One-way 

interaction 

ShowCeV 

Mother 

cev  needs  to  be 
visible 

-ownership 

-identifier 

-type 

-alignment 

-role 

-company 

-location 

-direction 

First  part  of  two- 
way  interaction 

HideCev 

Mother 

cev  needs  to  be 
invisible 

-  indentifier 

One-way 

interaction 

KilledCCV 

Mother 

When  Cev  killed 
as  shown  by 
these  PDUs; 
Vehicleimpact 
Collision 
IndirectFire 

-  identifier 

One-way 

interaction 

SimAllocated 

Place 

Combat  vehicle 
simulator 
allocated  to 
company  at  SCC 
Console 

-  identifier 

-  company 

One-way 

interaction 

SimPlaced 

Pla'e 

Combat  vehicle 
simulator  placed 
at  SCC  Console 

-  identifier 

One-way 

interaction 

SimProblem 

Mother 

If  combat  vehicle 
simulator 

-  didn’t  respond 
to  ActivatePDU, 

-  not  sending 
Vehicle 
Appearance 

PDUs  after 
sending 

Activating  PDU, 

-  stopped 
sending  Vehicle 
Appearance 
PDUs. 

-  identifier 

-  problem 

One-way 

interaction 

ActivateVehicle 

Mother 

Activate  or 
reconstitute 
combat  vehicle 
simulator 

-  identifier 

-  reason 
-type 

-  location 

-  alignment 

-  bumper  # 

-  hull  and 
turret 

orientation 

-  supplies  and 
failure  status 

First  part  of  two- 
way  interaction 
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ActivateResult 

Mother 

Placed  combat 
vehicle  or  CCV. 

-  identifier 

-  result 

Second  part  of 
two-way 
interaction 
(either 

ShowCCV  or 
ActivateVehicle) 

Arty  Dispatch 

FSE 

BattleMaster 
wants  to  dispatch 
platoon  of 
howitzers 

-  identifier 

-  platoon 

One-way 

interaction 

Arty  Arrive 

FSE 

Howitzers  have 
arrived 

-  identifier 

-  platoon 

-  location 

-  azimuth 

One-way 

interaction 

Arty 

Reconstitute 

FSE 

BattleMaster 
wants  to 
reconstitute 
platoon  of 
howitzer  battery 

-  identifier 

-  platoon 

-  location 

-  supply 
quantities 

One-way 

interaction 

Sorties 

CAS 

BattleMaster  has 
allocated  sorties 

-  number  of 
sorties 

-  number  of 
sorties  that 
maybe 
preplanned 

One-way 

interaction 

OepotDisplace 

Admin 

Maint 

BattleMaster  has 
displaced 
ammunition  or 
fuel  depots 

One-way 

Interaction 

Truck 

Reconstitute 

Admin 

Maint 

Supply  truck  or 

maintenance 

team 

reconstituted 

-  identifier 
-type 

-  location 

-  supplies 

-  company 

-  force 

One-way 

interaction 

Table  2.2-1;  SCC  Process  Interprocess  Messages 
It  is  broken  down  into  the  following  second  level  CSUs: 

Initialization 

Placing  Combat  Vehicles 
Placing  Static  Vehicles 
Communication  with  World 


2.2.1  Initialization 

The  SCC  first  opens  a  connection  so  that  it  can  communicate  with  the  SCC  Macintosh. 
The  SCC  spawns  the  other  console  processes  as  it  receives  the  corresponding  messages 
from  the  SCC  Macintosh.  It  sends  all  of  the  available  terrain  information  to  ^e  SCC  Mac 
so  the  user  can  choose  which  database  to  use  to  fight  the  battle.  In  addition,  the  SCC  Mac 
allows  a  "Battlemaster",  who  is  equipped  with  the  correct  password,  to  reconstitute 
vehicles  as  the  battle  progresses.  The  SCC  process  receives  messages  to  reconstitute 
vehicles  and  sends  a  message  to  the  Mother  process  to  either  change  the  location  of  the 
CCV  or  deactivate  and  re-activate  a  combat  vehicle  simulator.  Any  of  the  CCVs  or  the 
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MCCs  combat  vehicles  may  be  reconstituted.  The  Battlemaster  may  also  change  the 
locations  of  any  of  the  depots.  The  new  locations  are  sent  to  the  SCC  to  update  its  data. 
The  Initialization  CSC  is  composed  of  the  following  CSUs: 

cas.c 

css.c 

fse.c 

main.c 

terrain.c 

cew.c 


2.2. 1.1  cas.c 

/simnet/mcc/SCC/cas.c 

cas.c  contains  routines  that  implement  theSCC  support  for  the  CloseAirSupport 
Simulation. 

2. 2. 1.1.1  ProcessCASRequest 

ProcessCASRequest  processes  a  request,  t,  from  the  Macintosh  to  start  the  CAS  console. 
The  function  call  is  ProcessCASRequest(t).  Table  2.2-2  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/i  nclude/bridqe .  h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

req 

pointer  to  SCCCASRequest 

/si  mnet/mcc/i  nclude/SCC .  h 

1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

LookupProcessNumber 

Section  2.21.1.26.3. 

SendMCCMsqO 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

TurnRadioOn 

Section  2.21.1.23.3. 

Spawn  Process 

Section  2.21.1.26.1. 

1  Called  Bv  1 

Function 

Where  Described 

RequestArrived 

Section  2. 2. 1.4.3. 

Table  2.2-2;  ProcessCASRequest  Information. 

2.2. 1.2  css.c 

/simnet/mcc/SCC/css.c 

css.c  contains  routines  that  implement  the  SCC  support  for  Combat  Service  Support.  It 
also  handles  some  aspects  of  the  reconstitution  of  vehicles. 
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2 . 2 . 1 . 2 . 1  ProcessT  ruckInitRequest 


ProcessTruckInitRequest  processes  a  request,  t,  from  the  Macintosh  supplying  truck 
initialization  or  reconstitution  parameters.  The  function  call  is  ProcessTrucklnitRequest(t). 
Table  2.2-3  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

req 

register  pointer  to 

SCCT  ruckInitRequest 

/si  mnet/mcc/i  nclude/SCC .  h 

1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

LookupProcessNumber 

Section  2.21.1.26.3. 

ReconstituteTruck 

Section  2. 2. 1.2.3. 

InitializeTruck 

Section  2.2. 1.2.2. 

SendConsoleResponse 

Section  2.21.1.7.6. 

1  Called  Bv  1 

Function 

Where  Described 

RequestArrived 

Section  2.2.1. 4.3. 

Table  2.2-3:  ProcessTruckInitRequest  Information. 


2.2. 1.2.2  InitializeTruck 


InitializeTruck  records  a  truck’s  initial  parameters,  given  by  req,  in  shared  memory.  The 
function  call  is  InitializeTrack(req).  Table  2.2-4  describes  the  parameters  used  and 
functions  called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

InitUnit 

Section  2.21.1.19.4. 

GetT  ruckParameters 

Section  2.21.1.29.1. 

Called  By 

Function 

Where  Described 

ProcessTruckInitRequest 

Section  2.2.1. 2.1. 

Table  2.2*4:  InitializeTruck  Information. 


2.2. 1.2.3  ReconstituteTruck 

ReconstituteTruck  tells  the  Admin  or  Maint  process  to  reconstitute  a  truck,  req  contains 
information  which  describes  the  truck’s  alignment,  caspabilities  and  location.  The  function 
call  is  ReconstituteTruck(req).  Table  2.2-5  describes  the  parameters  used  and  functions 
called  using  this  function,  req  holds  information  about  a  truck's  alignment,  capabilities, 
and  location. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

req 

register  pointer  to 

SCOT  ruckInitRequest 

/si  mnet/mcc/i  nclude/SCC.  h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

process 

int 

Standard  C  type. 

msg 

MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

Calls 

Function 

Where  Described 

InitUnit 

Section  2.21.1.19.4. 

SendMCCMsql 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

Called  By 

Function 

Where  Described 

ProcessTruckInitRequest 

Section  2.2.1 .2.1. 

Table  2.2-5:  ReconstituteTruck  Information. 


2 . 2 . 1 . 2 .4  ProcessUMCPDisplaceRequest 


ProcessUMCPDisplaceRequest  processes  a  request,  t,  from  the  SCC  console  to  displace 
the  UMCP.  The  function  call  is  ProcessUMCPDisplaceRequest(t).  Table  2.2-6  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/include/bridqe .  h 
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1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

req 

pointer  to 

SCCUMCPDisplaceRequest 

/si  mnet/mcc/i  nctude/SCC.  h 

1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

LookupProcessNumber 

Section  2.21.1.26.3. 

SendMCCMsqO 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h 

1  Called  By  I 

Function 

Where  Described 

RequestArrived 

Section  2. 2. 1.4.3. 

Table  2.2-6:  ProcessUMCPDisplaceRequest  Information. 

2. 2. 1.2. 5  ProcessDepotRequest 

ProcessDepotRequest  processes  a  request,  t,  from  the  SCC  console  reporting  the  locations 
of  ammo  and  fuel  depots.  The  function  call  is  ProcessDepotRequest(t).  Table  2.2-7 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  j 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

req 

pointer  to 

SCCDepotsRequest 

/si  mnet/mcc/i  nclude/SCC .  h 

Calls 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  simnet/mcc/include/bridqe.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

LookupProcessNumber 

Section  2.21.1.26.3. 

SendMCCMsqO 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

Called  By 

Function 

Where  Described 

RequestArrived 

Section  2. 2. 1.4.3. 

Table  2.2-7:  ProcessDepotRequest  Information. 


2.2. 1.2.6  ProcessCSSRequest 

ProcessCSSRequest  processes  a  request,  t,  from  the  SCC  console  marking  the  completion 
of  the  CSS  batt^ion  initialization.  The  function  call  is  ProcessCSSRequest(t).  Table  2.2-8 
describes  the  parameters  used  and  functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

rea 

pointer  to  SCCCSSRequest 

/simnet/mcc/include/SCC.h 

i 

int 

Standard  C  type. 

Pt 

LongPt 

/simnet/common/include/glob 

al/lonqpt.h 

unit 

OrganizationalLinit 

/si  mnet/common/i  nclude/prot 
ocol/basic.h 

capabilities 

VehicleCapabilities 

/simnet/common/include/prot 

ocol/basic.h 

guises 

VehicleGuises 

/simnet/common/include/prot 

ocol/basic.h 

marking 

VehicleMarking 

/simnet/common/include/prot 

ocol/basic.h 

1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

GetGuises 

Section  2.21.1.17.1. 

InitUnit 

Section  2.21.1.19.4 

DisplavCCV 

Section  2.21.1.6.1. 

TurnRadioOn 

Section  2.21.1.23.3. 

SpawnProcess 

Section  2.21.1.26.1. 

SendConsoleResponse 

Section  2.21.1.7.6. 

1  Called  By  1 

Function 

Where  Described 

RequestArrived 

Section  2.2.1. 4.3. 

Table  2.2-8:  ProcessCSSRequest  Information. 


2 . 2 . 1 . 2 . 7  ProcessT  ruckQuery  Request 

ProcessTruckQueryRequest  processes  a  request,  t,  frorr  the  Macintosh  for  the  current  state 
of  a  truck.  The  function  call  is  ProcessTruckQueryRequest(t).  Table  2.2-9  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


Parameters 


inter  to  Transaction 


Where  Tvoedef  Declared 


/SI  mnet/mcc/i  nclude/bndoe .  h 
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1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

req 

register  pointer  to 

SCOT  ruckQuervRequest 

/simnet/mcc/include/SCC.h 

rsp 

register  pointer  to 
SCCToickQuerv  Response 

/simnet/mcc/include/SCC.h 

pars 

pointer  to  TruckParameters 

capabilities 

VehicleCapabiiities 

/simnet/common/include/prot 

ocol/basic.h 

unit 

OrganizationalUnit 

/simnet/common/include/prot 

ocol/basic.h 

1  Calls  1 

Function 

Where  Described 

ATPReouestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

GetT  ruckParameters 

Section  2.21.1.29.1. 

SendConsoleResponse 

Section  2.21.1.7.6. 

1  Called  By  I 

Function 

Where  Described 

RequestArrived 

Section  2.2.1. 4.3. 

Table  2.2*9:  ProcessTruckQueryRequest  Information. 


2.2. 1.3  fse.c 

/simnet/mcc/SCC/fse.c 

fse.c  contains  routines  which  implement  the  SCC  process  support  to  the  Fire  Support 
Element. 

2.2. 1.3.1  ProcessFSERequest 

ProcessFSERequest  processes  a  request,  t,  from  the  Macintosh  to  start  the  FSE  console. 
The  function  call  is  IfrocessFSERequest(t).  Table  2.2-10  describes  the  parameters  used 
and  functions  called  using  this  function. 


Parameter 


Variable 


Parameters 


inter  to  Transaction 


Where  Tvnedef  Declared 


/SI  mnet/mcc/i  nclude/bndae .  h 


internal  Variables 


e 


inter  to  SCCFSERequest 


short 


short 


Where  Tvpedef  Declared 


/si  mnet/mcc/i  nclude/SCC .  h 


Standard  C  t 


Calls 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

TurnRadioOn 

Section  2.21.1.23.3. 

Spawn  Process 

Section  2.21.1.26.1. 

SendConsoleResponse 

Section  2.21.1.7.6. 
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Called  By 

Function 

Where  Described 

RequestArrived 

Section  2.2.1. 4.3. 

Table  2.2-10:  ProcessFSERequest  Information. 

2 . 2 . 1 . 3 . 2  ProcessArtyQuery  Request 

ProcessArtyQuery'Request  processes  a  request,  r,  from  the  Macintosh  to  supply  the  latest 
status  of  the  artillery.  The  f^unction  call  is  ProcessArtyQueiyRequest(t).  Table  2.2-11 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/i  nclude/bridqe .  h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

req 

pointer  to 

SCCArtvQueryRequest 

/si  mnet/mcc/i  nclude/SCC .  h 

rsp 

pointer  to 

SCCArtyQueryResponse 

/si  mnet/mcc/i  nclude/SCC.  h 

battery 

short 

Standard  C  type. 

i 

short 

Standard  C  type. 

Calls 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

Called  By 

Function 

Where  Described 

RequestArrived 

Section  2.2.1. 4.3. 

Table  2.2-11:  ProcessArtyQueryRequest  Information. 


2 . 2 . 1 . 3 . 3  Process  ArtyReconstRequest 

ProcessArtyReconstRequest  processes  a  request,  t,  from  the  Macintosh  to  reconstitute  an 
artillery  battery.  The  function  call  is  ProcessArtyReconstRequest(t).  Table  2.2-12 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/i  nclude/bridqe .  h 

1  I 
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1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

req 

pointer  to 

SCCArtvReconstRequest 

/simnet/mcc/include/SCC.h 

msg 

MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

i 

short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

ATPReouestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

SendMCCMsol 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

1  Called  Bv  1 

Function 

Where  Described 

RequestArrived 

Section  2.2.1. 4.3. 

Table  2.2-12:  ProcessArtyReconstRequest  Information. 


2 . 2 . 1 . 3 . 4  Process  ArtyDispatchRequest 

ProcessArtyDispatchRequest  processes  a  request,  t,  from  the  Macintosh  to  displace  a 
howitzer  battery.  The  function  call  is  ProcessArtyDispatchRequest(t).  Table  2.2-13 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


Variable 


req 


Parameters 


Where  Typedef  Declared 


/si  mnet/mcc/i  nclude/btidae .  h 


Internal  Variables 


e 


pointer  to 

SCCArtyDisDatchReouest 


MCCMessageBuffer 


Where  Tvnedef  Declared 


/si  mnet/mcc/i  nclude/SCC.  h 


/SI  mnet/mcc/i  nclude/M  CCJpc 
•h 


Function 


ATPReouestData 


SendConsoleResDonse 


SendMCCMsol 


Calls 


Where  Described 


Macro  defined  in  /simnet/mcc/include/bridqe.h. 


Section  2.21.1.7.6. 


Macro  defined  in  /simnet/mcc/include/MCC  i 


Function 


RequestArrived 


Called  B 


Where  Described 


Section  2.2.1. 4.3. 


Table  2.2-13:  ProcessArtyDispatchRequest  Information. 
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2 . 2 . 1 . 3 . 5  ProcessArtyArri  veRequest 

ProcessArtyArriveRequest  processes  a  request,  t,  from  the  Macintosh  indicating  which 
howitzer  battery  has  arrived.  The  function  call  is  ProcessArtyArriveRequest(t).  Table  2.2- 
14  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/include/bridqe .  h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

req 

pointer  to 

SCC  Arty  Arrive  Request 

/simnet/mcc/include/SCC.h 

msg 

MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

i 

short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

ATPReauestData 

Macro  defined  in  /simnet/mcc/include/bridoe.h. 

SendConsoleResoonse 

Section  2.21.1.7.6. 

SendMCCMsat 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

1  Called  By  I 

Function 

Where  Described 

RequestArrived 

Section  2.2. 1.4.3. 

Table  2.2*14:  ProcessArtyArriveRequest  Information. 

2.2. 1.4  main.c 

/simnet/mcc/SCC/main.c 

main.c  contains  the  host  process  that  is  a  counterpart  to  the  SIMNET  Control  Console 
Macintosh. 

2. 2. 1.4.1  main 


main  is  the  entry  point  to  the  SCC  process.  The  function  call  is  main(argc,  argv).  Table 
2.2-15  describes  Ae  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

arqc 

int 

Standard  C  type. 

arqv 

pointer  to  pointer  to  char 

Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

InitializeProcess 

Section  2.21.1.19.1. 

InitRadios 

Section  2.21.1.23.1. 

OpenHostSocket 

Section  2.21.1.7.1. 

ActivateConsole 

Section  2.21.1.7.2. 

AlarmsEnabled 

Section  2.21.2.4.4. 

Table  2.2-15:  main  Information. 

2. 2. 1.4. 2  ProcessMessage 

ProcessMessage  processes  a  message  from  another  process,  type  describes  the  message  as 
either  one-way,  a  synchronous  or  asynchronous  request  or  an  asynchronous  respones. 
kind  describes  Ae  land  of  message,  length  is  the  length  of  the  data  buffer  and  data  is  a 
pointer  to  an  MCCMessageBuffer.  The  function  call  is  ProcessMessageftype,  kind, 
length,  data).  Table  2.2-16  describes  the  parameters  used  and  functions  c^ed  using  this 
function. 


1  Parameters  I 

1  Parameter 

Type 

Where  Tvpedef  Declared 

int 

Standard  C  type. 

kind 

Iona 

Standard  C  type. 

length 

int 

Standard  C  type. 

data 

register  pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

alarmsEnabied 

int 

Standard  C  type. 

1  Errors  1 

Error  Name 

Reason  for  Error 

MCC  UNEXPECTED  MESS 
AGE 

Message  type  was  unexpected. 

1  Calls  1 

Function 

Where  Described 

AlarmsEnabled 

Section  2.21.2.4.4. 

ProcessExitMessaqe 

Section  2.2.4.2.2. 

RestartConsole 

Section  2. 2.4. 1.1. 

ResetClock 

Section  2.2. 1.4.4. 

BroadcastToChildren 

Section  2. 2. 1.4.5. 

TaraetKilled 

Section  2.2.3.2.2. 

TurnRadioOff 

Section  2.21.1.23.4. 

ReportSimProblem 

Section  2. 2. 2. 1.5. 

SimAllocedRemotely 

Section  2.2.2.I.3. 

SimPlacedRemotely 

Section  2. 2. 2. 1.4. 

Table  2.2-16:  ProcessMessage  Information. 
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2.2. 1.4.3  RequestArrived 

RequestAnived  processes  an  ATP  Request,  t,  from  the  SCC  Macintosh.  The  function  call 
is  RequestArriv^(t).  Table  2.2-17  describes  the  parameters  used,  errors  returned  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/i  nclude/bridqe .  h 

Internal  Variables 

Variable 

Where  Tvoedef  Declared 

vehicle 

int 

Standard  C  type. 

1  Errors  I 

Error  Name 

Reason  for  Error 

MCC  GETREQUEST  FAILE 

D 

ATPGetRequest  failed. 

MCC  UNKNOWN  REQUEST 

Unknown  request  from  Macintosh. 
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1  Calls  1 

Function 

Where  Described 

ATPGet  Request 

Section  2.21.1.1.5. 

ProcessTerrainRequest 

Section  2. 2. 1.5.1. 

ProcessMapSheetsRequest 

Section  2.2. 1.5.2. 

ProcessExerciseRequest 

Section  2.2.1. 5.3. 

ProcessGrid  1  nf  o  Request 

Section  2.21.1.16.1. 

ProcessTOCRequest 

Section  2  2.3.1.1. 

ProcessALOCRequest 

Section  2.2.3. 1.3. 

ProcessTruckInitRequest 

Section  2.2. 1.2.1. 

Process!  ruckQuervRequest 

Section  2.2.1. 2.7. 

ProcessCSSRequest 

Section  2.2. 1.2.6. 

ProcessFSERequest 

Section  2.2. 1.3.1. 

ProcessCASRequest 

Section  2.2. 1.1.1. 

ProcessStopRequest 

Section  2. 2.4.2. 1. 

Process!  arqetSetRequest 

Section  2.2.3.2.I. 

ProcessArtvQuervRequest 

Section  2. 2. 1.3.2. 

ProcessArtvReconstRequest 

Section  2. 2. 1.3.3. 

ProcessDepotRequest 

Section  2. 2. 1.2.5. 

Process  Arty  Dispatch  Request 

Section  2  2.1.3.4. 

ProcessArtyArriveRequest 

Section  2.2. 1.3.5. 

Process!OCDispatchRequest 

Section  2.2  3.1.2. 

ProcessALOCOispatch 

Request 

Section  2. 2.3. 1.4. 

ProcessPermitOptions 

Request 

Section  2.2. 1.4.6. 

ProcessSimExistsRequest 

Section  2.21.1.25.1. 

ProcessSimlnitRequest 

Section  2.21.1.25.2. 

SimPlacedLocally 

Section  2.2.2.I.2. 

ProcessoimQueryRequest 

Section  2.21.1.25.4. 

ProcessSimAllocRequest 

Section  2.2.2.I.I. 

ProcessUMCPDisplace 

Request 

Section  2.2. 1.2.4. 

ProcessCEWinitRequest 

Section  2.2.1. 6.1. 

ProcessCEWReconst 

Request 

Section  2. 2. 1.6.5. 

ProcessCEWQueryRequest 

Section  2. 2. 1.6. 2. 

ProcessCEWStartRequest 

Section  2. 2. 1.6.3. 

Table  2.2-17:  RequestArrived  Information. 


2. 2. 1.4. 4  ResetClock 

ResetClock  tells  the  Macintosh  what  time  it  is.  The  function  call  is  ResetClock().  Table 
2.2-18  describes  the  internal  variable  used  and  functions  called  using  this  function. 


Variable 


Internal  Variables 


SCCCIockRequesl 


Where  Tynedef  Declared 


/simnet/mcc/include/SCC.h 
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1  Calls  1 

Function 

Where  Described 

MacintoshTime 

Section  2.21.1.27.1. 

ATPPut 

Section  2.21.1.7.4. 

Called  By 

Function 

Where  Described 

ProcessMessaqe 

Section  2.2.1 .4.2. 

Table  2.2-18:  ResetClock  Information. 

2. 2. 1.4. 5  BroadcastToChildren 

BroadcastToChildren  sends  a  message  to  each  process  that  has  been  spawned,  kind  is  the 
kind  of  IPC  message  being  sent.  The  message  contains  no  data.  The  function  call  is 
BroadcastToChildren(kind).  Table  2.2-19  describes  the  parameters  used  and  functions 
called  using  this  function,  kind  is  the  kind  of  IPC  message  being  sent.  The  message  has 
no  data  to  it. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

kind 

lonq 

Standard  C  type. 

r 

1  Internal  Variables 

Variable 

Where  Typedef  Declared 

0 

reqister  int 

Standard  C  type. 

.  nypid 

reqister  int 

Standard  C  type. 

numberChildren 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

numberChildren 

int 

Number  ot  children  notified. 

1  Calls  1 

Function 

Where  Described 

SendMCCMsqO 

Macro  defined  in  /simnet/nncc/include/MCC  ipc.h 

1  Called  By  I 

Function 

Where  Described 

ProcessMessaqe 

Section  2. 2. 1.4. 2. 

ShutdownChildren 

Section  2. 2. 4. 2.4. 

Table  2.2-19:  BroadcastToChildren  Information. 

2.2. 1 .4.6  ProcessPermitOptionsRequest 

ProcessPermitOptionsRequest  processes  a  lequest,  t,  from  the  console  as  to  what  optional 
elements  are  permitted.  TTie  function  call  is  PtocessPermitOptionsRequest''t).  Table  2.2- 
20  describes  the  parameters  used  and  functions  called  using  this  functicr.. 
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1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/i  nclude/bridqe .  h 

1 

Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

rsp 

pointer  to 

SCCPermitOptionsResponse 

/simnet/mcc/include/SCC.h 

Calls 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

Called  Bv 

Function 

Where  Described 

RequestArrived 

Section  2. 2. 1.4.3. 

Table  2.2-20:  ProcessPermitOptionsRequest  Information. 


2.2. 1.5  terrain. c 

/simnet/mcc/SCC/terrain.c 


terrain.c  contains  routines  which  tell  the  Macintosh  about  the  terrain  database.  Table 
2.2-21  shows  the  variables  used  by  terrain.c. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

terrains 

array  maxNumberTerrains  of 
TDB  INFO 

/simnet/commoh'libsrc/libtdb/t 

db.h 

Table  2.2-21:  terrain.c  Variable  Information. 


2.2. 1.5.1  ProcessTerrainRequest 

ProcessTerrainRequest  processes  a  request,  t,  from  the  Macintosh  for  terrain  information. 
The  function  call  is  ProcessTerrainRequest(t).  Table  2.2-22  describes  the  parameters  used, 
errors  returned  and  functions  called  using  this  function. 


Parameter 


Variable 


Parameters 


inter  to  Transaction 


Where  Tvpedef  Declared 


/simnet/mcc/include/bridae.h 


Internal  Variables 


e  Where  Tvoedef  Declared 


inter  to  SCCTerrainReauest  /simnet/mcc/include/SCC.h 


pointer  to  |  /simnet/mcc/include/SCC.h 

SCCTerrainResDonse  i 


Error  Name 


MCC  NO  TERRAIN 


Errors 


Reason  tor  Error 
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Calls 

Function 

Where  Described 

ATPRequestDala 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

tdb  aet  tdb  info 

Section  2.21.7.27.3. 

Called  By 

Function 

Where  Described 

RequestArrived 

Section  2.2.1 .4.3. 

Table  2.2-22:  ProcessTerraInRequest  Information. 

2 . 2 . 1 . 5 . 2  ProcessMapSheetsRequest 

ProcessMapSheetsRequest  processes  a  request,  t,  for  map  sheets  data  from  the  Macintosh. 
This  implementation  relies  on  an  assumption  that  the  sccMapSheetsTrans  request  will  come 
after  the  sccTerrainTrans  for  a  terrain  patch.  The  function  call  is 
ProcessMapSheetsRequest(t).  Table  2.2-23  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

Internal  variables 

Variable 

Type 

Where  Typedef  Declared 

req 

pointer  to 

SCCMapSheetsRequest 

/si  mnet/mcc/i  nclude/SCC .  h 

rsp 

pointer  to 

SCCM  apSheetsResponse 

/si  mnet/mcc/i  nclude/SCC .  h 

1  Calls  1 

Function 

Where  Described 

ATPRequestDala 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

1  Called  By  I 

Function 

Where  Described 

RequestArrived 

Section  2.2. 1.4.3. 

Table  2.2-23:  ProcessMapSheetsRequest  Information. 

2.2. 1.5.3  ProcessExerciseRequest 

ProcessExerciseRequest  notes  the  start  of  an  exercise  at  the  Macintosh,  specified  by  t.  The 
function  call  is  ProcessExerciseRequest(t).  Table  2.2-24  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/include/bridqe .  h 
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variable 


req 


Internal  Variables 


pointer  to 

SCCExerciseRequest 


pointer  to 

SCCExerciseResoonse 


MCCMessageBuffer 


Where  Typedef  Declared 


/si  mnet/mcc/i  nclude/SCC.  h 


/simnet/mcc/include/SCC.h 


/simnet/mcc/include/MCCJpc 

•h 


Standard  C  t 


Function 


ATPReouestData 


SendConsoleResoonse 


SendMCCMsoO 


SpawnProcess 


Calls 


Where  Described 


Macro  defined  in  /simnet/mcc/include/bridae.h. 


Section  2.21.1.7.6. 


Macro  defined  in  /simnet/mcc/include/MCC  i 


Section  2.21.1.26.1. 


Called  B 


Function 

Where  Described 

RequestArrived 

Section  2. 2. 1.4.3. 

Table  2.2-24:  ProcessExerciseRequest  Information. 

2.2. 1.6  cew.c 

/simnet/mcc/SCC/cew.c 

cew.c  contains  routines  to  handle  the  Combat  Engineering  Workstation. 

2.2. 1.6.1  ProcessCEWInitRequest 

ProcessCEWInitRequest  processes  a  request,  t ,  which  initializes  the  specified  CEW 
vehicle  and  loads  it  into  shared  memory.  The  function  call  is  ProcessCEWInitRequest(t). 
Table  2.2-25  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


Parameters 


inter  to  Transaction 


Where  Tvoedef  Declared 


/simnet/mcc/include/bndqe.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

req 

pointer  to 

SCCCEWlnitRequest 

/si  mnet/mcc/i  nclude/SCC .  h 

pars 

pointer  to  CEWParameters 

/simnet/mcc/include/MCC_par 

s.h 

organization 

OrganizationalUnit 

/simnet/common/include/prot 

ocol/basic.h 

vehicleindex 

short 

Standard  C  tvoe. 
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1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

GetSCCVehicleIndex 

Section  2.2.1. 6.4. 

GetCEWParameters 

Section  2.21.1.8.1. 

InitUnit 

Section  2.21.1.19.4. 

SendConsoleResponse 

Section  2.21.1.7.6. 

Called  By 

Function 

Where  Described 

RequestArrived 

Section  2. 2. 1.4.3. 

Table  2.2-25:  ProcessCEWInitRequest  Information. 


2. 2. 1.6. 2  ProcessCEWQueryRequest 

ProcessCEWQueryRequest  returns  current  information  to  the  Mac  CEW  console  about  the 
specified  CEW  vehicle.  The  function  call  is  ProcessCEWQueryR^uest  (t).  Table  2.2-26 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


Parameters 


inter  to  Transaction 


Where  Tvoedef  Declared 


/simnet/mcc/include/bridqe.h 


internal  Variables 

Variable 

Where  Tvpedef  Declared 

rsp 

pointer  to 

SCCCEWQuervResponse 

/si  mnet/mcc/i  nclude/SCC .  h 

req 

pointer  to 

SCCCEWQueryRequest 

/si  mnet/mcc/i  nclude/SCC .  h 

pars 

pointer  to  CEWParameters 

/simnet/mcc/include/MCC_par 

s.h 

tmpKind 

short 

Standard  C  type. 

tmoVehicle 


vehicleindex 


Standard  C  t 


Standard  C  type. 


Function 


ATPReouestData 


GetSCCVehicleIndex 


GetCEWParameters 


SendConsole  Response 


Calls 


Where  Described 


Macro  defined  in  /simnet/mcc/include/bridae.h. 


Section  2. 2. 1.6.4. 


Section  2.21.1.8.1. 


Section  2.21.1.7.6. 


Function 


RequestArrived 


Called  B 


Where  Described 


Section  2.2. 1.4.3. 


Table  2.2-26:  ProcessCEWQueryRequest  Information. 
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2. 2. 1.6. 3  ProcessCEWStartRequest 

ProcessCEWStartRequest  spawns  the  CEW  process  and  loads  the  number  of  each  type  of 
CEW  vehicle  into  shared  memory.  The  function  call  is  ProcessCEWStartRequest(t).  Table 
2.2-27  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/i  nclude/bridqe .  h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

req 

pointer  to 

SCCCEWStartRequest 

/si  mnet/mcc/include/SCC .  h 

1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SpawnProcess 

Section  2.21.1.26.1. 

SendConsoleResponse 

Section  2.21.1.7.6. 

1  Called  By  I 

Function 

Where  Described 

RequestArrived 

Section  2. 2. 1.4.3. 

Table  2.2-27;  ProcessCEWStartRequest  Information. 

2.2. 1.6.4  GetSCCVehicleIndex 

GetSCCVehicleIndex  returns  the  index  used  by  the  SCC  process  given  the  vehicle 
identifier,  sccVehicle,  passed  in  by  the  SCC  console.  The  function  call  is 
GetSCCVehiclelndex(sccVehicle).  Table  2.2-28  describes  the  parameters  used  by  this 
function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared  1 

sccVehicle 

short 

Standard  C  type.  1 

Return  Values 

Return  Value 

Type 

Meaning 

sccVehicle  -1 

short 

Vehicle  index. 

Called  By 

Function 

Where  Described 

ProcessCEWInitRequest 

Section  2. 2. 1.6.1. 

ProcessCEWQueryRequest 

Section  2.2. 1.6.2. 

Table  2.2-28:  GetSCCVehicleIndex  Information. 
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2 . 2 . 1 . 6 . 5  Proce$sCEWReconstRequest 

ProcessCEWReconstRequest  redirects  the  CEW  vehicle  reconstitute  message  to  the  CEW 
process.  The  function  c^  is  ProcessCEWReconstR^uest(t).  Table  2.2-29  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

■  Parameter 

Where  Tvpedef  Declared 

b _ _ _ 

pointer  to  Transaction 

/si  mnet/mcc/i  nclude/bridqe  .h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

req 

pointer  to 

SCCCEWReconstRequest 

/simnet/mcc/i  nclude/SCC .  h 

msg 

MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

i 

short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SendConsoleResoonse 

Section  2.21.1.7.6. 

SendMCCMsql 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

1  Called  By  I 

Function 

Where  Described 

RequestArrived 

Section  2.2. 1.4.3. 

Table  2.2-29:  ProcessCEWReconstRequest  Information. 


2.2.2  Placing  Combat  Vehicles 

The  see  is  notified  when  a  simulator  is  to  be  allocated  to  a  company  or  placed  on  the 
terrain.  The  SCC  then  notifies  any  Placement  consoles  of  this  information.  It  sends  the 
place  information  to  Mother  and  waits  asynchronously  for  a  message  from  Mother  if  the 
simulator  failed  to  be  activated.  It  contains  one  CSU,  sim.c. 


2.2. 2.1  sim.c 

/simnet/mcc/SCC/sim.c 

sim.c  contains  routines  which  implement  the  control  of  the  vehicle  simulators  from  the 
SIMNET  Control  Console.  It  also  handles  some  aspects  of  reconstituting  vehicle 
simulators. 

2. 2. 2. 1.1  ProcessSimAllocRequest 

ProcessSimAllocRequest  processes  a  notification,  t,  from  the  SCC  Macintosh  that  a 
simulator  has  been  allocated  to  a  company.  The  function  call  is 
ProcessSimAllocRequest(t).  Table  2.2-30  describes  the  parameters  used  and  functions 
called  using  this  function. 
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1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridge.h 

Internal  Variables 

Variable 

Where  Tvoedef  Declared 

req 

pointer  to  SimAilocRequest 

/simnet/mcc/include/sim  xact. 
h 

msg 

MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

vehicle 

unsigned  short 

Standard  C  tvpe. 

1  Calls  1 

Function 

Where  Described 

ATPRec4ues(Data 

Macro  defined  in  /simnet/mcc/includeybridqe.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

SendMCCMsql 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

1  Called  Bv  1 

Function 

Where  Described 

RequestArrived 

Section  2. 2. 1.4.3. 

Table  2.2-30:  ProcessSimAllocRequest  Information. 

2. 2. 2. 1.2  SimPlacedLocally 

SimPlacedLocally  tells  the  Placement  process  that  the  SCC  console  has  been  used  to  place  a 
vehicle,  vehicle.  The  function  call  is  SimPlacedLocally(vehicle).  Table  2.2-31  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

vehicle 

unsigned  short 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

msg 

MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

1  Calls  1 

Function 

Where  Described 

SendMCCMsql 

Macro  defined  in  /simnet/mcc/include/MCC Jpc.h. 

1  Called  Bv  1 

Function 

Where  Described 

RequestArrived 

Section  2.2.1. 4.3. 

Table  2.2-31:  SimPlacedLocally  Information. 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.2.2. 1.3  SimAllocedRemotely 

SimAllocedRemotely  tells  the  SCC  console  that  a  certain  simulator  has  been  activated  from 
a  Placement  console.  The  function  call  is  SimAllocedRemotely(msg).  Table  2.2-32 
describes  the  parameters  used  and  functions  called  using  this  function,  msg  is  an  MCC 
message  buffer  that  contains  the  vehicle  that  was  allocated  and  the  company  to  which  it  was 
allocated  in  the  "allocated"  structure. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

msg 

pointer  to  MCCMessageBufter 

/simnet/mcc/include/MCC  ipc 
.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

req 

SimAllocRequest 

/simnet/mcc/include/sim  xact. 
h 

i 

short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

ATPPut 

Section  2.21.1.7.4. 

1  Called  By  1 

Function 

Where  Described 

ProcessMessage 

Section  2.2. 1.4.2. 

Table  2.2-32:  SimAllocedRemotely  Information. 


2. 2. 2. 1.4  SimPlacedRemotely 

SimPlacedRemotely  tells  the  SCC  console  that  a  certain  simulator,  specified  by  vehicle,  has 
been  activated  from  a  Placement  console.  The  function  call  is 

SimPlacedRemotely(vehicle).  Table  2.2-33  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

vehicle 

unsigned  short 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Sim 

register  pointer  to 
SimulatorStatus 

/simnet/mcc/include/veh_tabl 

e.h 

req 

SimPlacedRequest 

/simnet/mcc/include/sim  xact. 
h 

Calls 

Function 

Where  Described 

ATPPut 

Section  2.21.1.7.4. 

1  1 
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i  Called  By  I 

Function 

Where  Described 

ProcessMessaqe 

Section  2.2. 1.4.2. 

Table  2.2-33:  SimPlacedRemotely  Information. 

2.2.2. 1.5  ReportSimProblem 

ReportSimProblem  reports  a  problem,  problem,  with  the  simulator,  vehicle.  The  function 
call  is  ReportSiniProblem(problem,  vehicle).  Table  2.2-34  describes  the  parameters  used 
and  functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

problem 

SimProblem 

/simnet/mcc/Include/MCC  ipc 
.h 

vehicle 

unsigned  short 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

reg 

SCCSimProblemRequest 

/si  mnet/mcc/i  nclude/SCC .  h 

Calls 

Function 

Where  Described 

ATPPut 

Section  2.21.1.7.4. 

Called  By 

Function 

Where  Described 

ProcessMessaqe 

Section  2.2. 1.4.2. 

Table  2.2-34:  ReportSimProblem  Information. 


2.2.3  Placing  Static  Vehicleii 

The  see  is  used  to  initialize  the  other  Mee  consoles  and  their  eeVs.  There  are  some 
eeVs  which  do  not  belong  to  any  other  console  like  the  TOe  and  ALOe  eeVs.  These  are 
simply  placed  by  the  See.  Other  eeVs,  such  as  fuel  trucks,  ammo  trucks,  mortars  or 
howitzers,  are  also  given  an  initial  location  when  their  console  is  to  be  started.  The  See 
also  provides  a  way  to  place  gunnery  targets,  which  can  be  any  kind  of  vehicle  simulated 
by  the  Mee  to  be  placed  on  the  terrain.  These  gunnery  targets  do  not  move  across  the 
terrain  unless  they  are  reconstituted.  Their  only  movement  occurs  if  they  have  a  turret,  in 
which  case  their  turret  slews  back  and  forth  continuously.  Static  vehicle  placement  is  also 
handled  by  css.c  in  Section  2.2. 1.2  and  fse.c  in  Section  2.2. 1.3.  Please  reference  these 
sections  for  additional  information.  This  second  level  CSC  contains  the  following  CSUs: 

ccv.c 

target.c 
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2.2.3. 1  ccv.c 

/simnet/mcc/SCCyccv.c 

ccv.c  contains  routines  which  place  computer-controlled  vehicles,  like  the  TOC 
components  and  the  Admin/Log  Center,  on  the  terrain. 

2. 2. 3. 1.1  ProcessTOCRequest 

ProcessTOCRequest  places  the  TOC  on  the  terrain.  The  transaction,  t,  contains  data  for  a 
SCCTOCRequest.  This  holds  the  configuration  in  which  to  place  the  vehicles  of  the  TOC 
and  the  centr^  location.  It  also  contains  the  alignment  of  the  TOC.  The  function  call  is 
ProcessTOCRequest(t).  Table  2.2-35  describes  the  parameters  used  and  functions  called 
using  this  function. 


Parameter 


Parameters 


inter  to  Transaction 


Where  Tvoedef  Declared 


/simnet/mcc/include/bndae.h 


Variable 


S2A 


S3A 


fsA 


taA 


organization 


marking 


guises 


capabilities 


Internal  Variables 


e 


inter  to  SCCTOCRequest 


LongPt 


LongPt 


LongPt 


LongPt 


int 


int 


int 


int 


OrganizationalUnit 


VehicleMarking 


VehicleGuises 


VehicleCapabilities 


Where  Tvoedef  Declared 


/si  mnet/mcc/i  nclude/SCC .  h 


/simnet/commonAmctude/glob 

al/lonoDt.h 


/simnet/common/include/glob 

al/lonoDt.h 


/simnet/common/include/glob 

al/lonqot.h 


/simnet/common/include/glob 

al/lonqpt.h 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  t 


/simnet/common/include/prot 

ocol/basic.h 


/si  mnet/co  mmo  n/i  nclude/prot 
ocol/basic.h 


/simnet/common/mclude/prot 

ocol/basic.h 


/simnet/common/include/prot 

ocol/basic.h 


Function 


ATPRequestData 


GetGuises 


InitUnit 


DisplayCCV 


TurnRadioOn 


SendConsoleResponse 


Calls 


Where  Described 


Macro  defined  in  /simneVmcc/include/bridqe.h. 


Section  2.21.1.17.1. 


Section  2.21.1.19.4. 


Section  2.21.1.6.1. 


Section  2.21.1.23.3. 


Section  2.21.1.7.6. 
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1  Called  By  1 

Function 

Where  Described 

RequestArrived 

Section  2. 2. 1.4.3. 

Table  2.2*35:  ProcessTOCRequest  Information. 

2 . 2 . 3 . 1 . 2  ProcessTOCDispatchRequest 

ProcessTOCDispatchRequest  removes  the  TOC  from  the  terrain.  The  transaction,  t,  tells 
the  see  to  hide  the  vehicles  of  the  TOC  and  does  not  contain  any  other  relevant 
information.  The  function  call  is  ProcessTOCDispatchRequest(t).  Table  2.2-36  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/include/bridqe .  h 

Calls 

Function 

Where  Described 

SendConsoleResponse 

Section  2.21.1.7.6. 

HideCev 

Section  2.21.1.6.2. 

TurnRadioOff 

Section  2.21.1.23.1. 

Called  By 

Function 

Where  Described 

RequestArrived 

Section  2. 2. 1.4.3. 

Table  2.2-36:  ProcessTOCDispatchRequest  Information. 


2.2.3. 1.3  ProcessALOCRequest 

ProcessALOCRequest  places  the  Admin/Log  Center  on  the  terrain,  t  contains  an 
SCCALOCRequest  which  defines  the  alignment  of  the  ALOC  and  the  location.  The 
function  call  is  ProcessALOCRequest(t).  Table  2.2-37  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/i  nclude/bridqe .  h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

req 

pointer  to  SCCALOCRequest 

/si  mnet/mcc/i  nclude/SCC .  h 

organization 

OrganizationalUnit 

/simnet/common/include/prot 

ocol/basic.h 

marking 

VehicleMarking 

/simnet/common/include/prot 

ocol/basic.h 

guises 

VehicleGuises 

/si  mnet/co  mmon/i  nclude/prot 
ocol/basic.h 

capabilities 

VehicleCapabiiities 

/simnet/common/include/prot 

ocol/basic.h 
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1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

GetGuises 

Section  2.21.1.17.1. 

InitUnit 

Section  2.21.1.19.4. 

DisplayCCV 

Section  2.21.1.6.1. 

TurnRadioOn 

Section  2.21.1.23.3. 

SendConsoleResponse 

Section  2.21.1.7.6. 

Called  By 

Function 

Where  Described 

RequestArrived 

Section  2. 2. 1.4.3. 

Table  2.2-37:  ProcessALOCRequest  Information. 

t 

2 . 2 . 3 . 1 . 4  ProcessALOCDispatchRequest 

ProcessALOCDispatchRequest  removes  the  Admin/Log  Center  from  the  terrain,  t  is  an 
ALOCDispatchRequest,  and  does  not  contain  any  other  information.  The  function  call  is 
Process ALOCDispatchRequest(t).  Table  2.2-38  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

Calls 

Function 

Where  Described 

SendConsoleResponse 

Section  2.21.1.7.6. 

HideCCV 

Section  2.21.1.6.2. 

TurnRadioOft 

Section  2.21.1.23.4. 

Called  By 

Function 

Where  Described 

RequestArrived 

Section  2.2. 1.4.3. 

Table  2.2-38:  ProcessALOCDispatchRequest  Information. 

2. 2. 3. 2  target.c 

/simnet/mcc/S  CC/target.c 

target.c  contains  routines  which  implement  the  gunnery  targets.  Table  2.2-39  shows  the 
variables  used  by  target.c 


1  Variables  | 

Variable 

Where  Typedef  Declared 

vehTypeTable 

array  of  ObjectType 

/simnet/common/include/prot 

ocol/basic.h 

Table  2.2-39:  target.c  External  Variable  Information. 
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2 . 2 . 3 . 2 . 1  ProcessTargetSetRequest 

ProcessTargetSetRequest  processes  a  request,  t,  to  place  or  remove  a  target.  The  function 
call  is  ProcessTargetSetRequest(t).  Table  2.2-40  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameter 


Parameters 


inter  to  Transaction 


Where  Tyoedef  Declared 


/simnet/mcc/include/bndoe.h 


Variable 


req 


marking 


capabilities 


guises 


Internal  Variables 


e 


pointer  to 

SCCTaroetSetRequest 


VehicleMarking 


OrganizationalUnit 


VehicleCapabilities 


VehicleGuises 


Where  Typedef  Declared 


/si  mnet/mcc/i  nclude/SCC .  h 


/simnet/common/include/prot 

ocol/basic.h 


/simnet/common/include/prot 

ocol/basic.h 


/si  mnet/co  mmo  n/i  nclude/prot 
ocol/basic.h 


/simnet/common/include/prot 

ocol/basic.h 


Error  Name 


MCC  INCONSISTENCY 


Errors 


Reason  for  Error 


Internal  inconsistenc 


Function 


ATPReouestData 


HideCCV 


GetGuises 


InitUnit 


DisplavCCV 


SendConsoleResoonse 


Calls 


Where  Described 


Macro  defined  in  /simnet/mcc/include/bndqe.h. 


Section  2.21.1.6.2. 


Section  2.21.1.17.1. 


Section  2.21.1.19.4. 


Section  2.21.1.6.1. 


Section  2.21.1.7.6. 


Called  B 


Function 

Where  Described 

RequestArrived 

Section  2. 2. 1.4.3. 

Table  2.2-40:  ProcessTargetSetRequest  Information. 

2. 2. 3. 2. 2  TargetKilled 

TargetKilled  tells  a  Macintosh  when  a  gunnery  target,  specified  by  vehicle,  has  been 
destroyed.  The  function  call  is  TargetKilled(vehicle).  Table  2.2-41  describes  the 
parameters  used  and  functions  call^  using  this  function. 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

req 

SCCTarqetHitRequest 

/si  mnet/mcc/i  nclude/SCC .  h 

Calls 

Function 

Where  Described 

ATPPut 

Section  2.21.1.7.4. 

Called  By 

Function 

Where  Described 

ProcessMessaqe 

Section  2.2. 1.4.2. 

Table  2.2*41:  TargetKilled  Information. 


2.2.4  Communication  with  World 

The  see  listens  to  messages  that  come  from  Mother.  These  messages  are  generated  when 
a  packet  has  come  in  on  the  network  in  which  it  is  interested.  It  also  listens  to  all  of  the 
messages  coming  from  the  SCC  Macintosh,  such  as  placing  a  simulator,  reconstituting  a 
vehicle,  starting  a  console,  etc.  It  keeps  track  of  whether  a  console  has  started  properly  and 
retries  every  30  seconds  if  it  hasn't  started  yet.  When  the  SCC  is  sent  a  message  to  end  the 
exercise,  it  passes  this  message  on  to  each  of  the  spawned  processes  so  that  they  can 
recycle  themselves.  The  CSUs  are: 

restan.c 

stop.c 


2.2.4. 1  restart. c 

/simnet/mcc/S  CC/restart.c 


restart.c  contains  routines  which  attempt  to  restart  a  console  through  the  following  steps: 

1 .  The  console  process  is  sent  an  exist  message,  causing  it  to  recycle  its  Macintosh 
and  exit. 

2 .  There  is  a  10  second  delay  in  order  to  let  things  stabilize  and  the  Macintosh 
reboot. 

3 .  The  console  process  is  killed  if  it  still  exists. 

4 .  The  console  process  is  respawned. 


2. 2. 4. 1.1  RestartConsoIe 


RestartConsole  restans  a  console  identified  by  process  number,  p.  The  function  call  is 
RestartConsole(p).  Table  2.2-42  describes  the  parameters  used  and  functions  called  using 
this  function. 


1  Parameters  | 

1  Parameter 

Type _ 

Where  Typedef  Declared  1 

int 


Standard  C  tvoe. 
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1  Calls  1 

Function 

Where  Described 

SendMCCMsqO 

Macro  defined  in  /simnet/nxc/include/MCC  ipc.h 

SelAlarm 

Section  2.21.2.4.2. 

Called  By 

Function 

Where  Described 

ProcessMessaqe 

Section  2.2. 1.4.2. 

Table  2.2-42:  RestartConsole  Information. 

2. 2. 4. 1.2  Respawn 

Respawn  kills  and  then  restarts  a  process  identified  by  number.  This  process  is  called  by 
the  Alarm  package.  The  function  call  is  Respawn(p,  a).  Table  2.2-43  describes  the 
parameters  used,  errors  returned  and  functions  called  using  this  function,  p  is  the  process 
number  of  the  console  to  be  restarted. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

P 

lonq 

Standard  C  type. 

a 

pointer  to  Alarm 

/simnet/rcs/libipc/alarm.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

pid 

int 

Standard  C  type. 

1  Errors  I 

Error  Name 

Reason  for  Error 

MCC  RESPAWN  BEFORE 
SPAWN 

Process  was  never  originally  spawned,  which  means  it  was 
never  initialized  at  the  SCC. 

1  Calls  1 

Function 

Where  Described 

SpawnProcess 

Section  2.21.1.26.1. 

Table  2.2-43:  Respawn  Information. 


2. 2. 4. 2  stop.c 

/simnet/mcc/SCC/stop.c 

stop.c  contains  routines  for  stopping  the  SIMNET  Control  Console.  Table  2.2-44  shows 
the  variables  used  by  stop.c. 


1  Variables  I 

Variable 

Where  Typedef  Declared 

errno 

extern  int 

Standard  C  type. 

Table  2.2-44:  stop.c  External  Variables  Information. 
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2. 2. 4. 2.1  ProcessStopRequest 


ProcessStopRequest  shuts  down  the  exercise.  The  function  call  is  ProcessStopRequest(t). 
Table  2.2-45  describes  the  parameters  used  and  functions  called  using  this  function,  t  is 
the  transaction  that  contains  information  telling  the  other  processes  to  stop. 


\  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/i  nclude/bridqe .  h 

Calls 

Function 

Where  Described 

ATPResponse 

Section  2.21.1.1.6. 

Called  By 

Function 

Where  Described 

RequestArrived 

Section  2. 2. 1.4.3. 

Table  2.2-45:  ProcessStopRequest  Information. 

2. 2. 4. 2. 2  ProcessExitMessage 

ProcessExitMessage  is  called  when  a  technician  terminates  the  MCC  exercise.  The 
function  call  is  ProcessExitMessage().  Table  2.2-46  describes  the  functions  called  by  this 
function. 


1  Calls  1 

Function 

Where  Described 

ShutdownChildren 

Section  2.2.4.2.4. 

Re  move  Radios 

Section  2.21.1.23.2. 

ATPTransact 

Section  2.21.1.7.3. 

CloseSocket 

Section  2.21.2.10.4. 

Called  By 

Function 

Where  Described 

ProcessMessaqe 

Section  2. 2. 1.4. 2. 

Table  2.2-46:  ProcessExitMessage  Information. 

2. 2. 4. 2. 3  ExerciseStopped 

ExerciseStopped  is  called  when  the  BattleMaster  terminates  the  MCC  exercise.  The 
function  call  is  ExerciseStopped(t).  Table  2.2-47  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function,  t  holds  no  relevant  information. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/i  nclude/bridqe .  h 

1  1 
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1  Internal  Variables  i 

Variable 

Where  Typedef  Declared 

msg 

MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
h 

1  Calls  1 

Function 

Where  Described 

ShutdownChildren 

Section  2.2  4.2.4. 

Remove  Radios 

Section  2.21.1.23.2. 

SendMCCMsaO 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

Table  2.2-47:  ExerciseStopped  Information. 

2. 2. 4. 2. 4  ShutdownChiidren 

ShutdownChildren  sends  an  exit  message  to  all  children  and  waits  until  they  exit.  The 
function  call  is  ShutdownChildren().  Table  2.2-48  describes  the  functions  called  by  this 
function. 


1  Calls  1 

Function 

Where  Described 

BroadcastToChildren 

Section  2. 2. 1.4.5. 

Called  By 

Function 

Where  Described 

ExerciseStODoed 

Section  2.2.4.2.3. 

ProcessExitMessaqe 

Section  2.2.4.2.2. 

Table  2.2-48:  ShutdownChildren  Information. 
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2.3  The  Place  (Placement)  Process 

The  Place  process  places  combat  vehicles  on  the  battlefield  at  the  request  of  the  other 
console  processes.  Up  to  three  Placement  processes  are  allowed,  ^ch  Place  process  is 
directly  associated  with  a  particular  Place  console.  The  code  for  placing  vehicles  on  the 
battlefield  in  the  Place  process  is  virtually  the  same  as  the  code  for  vehicle  placement  in 
the  see  process.  Much  of  this  common  code  is  located  in  libmcc  (See  Section  2.21). 
The  structure  of  the  Place  process  is  shown  in  Figure  2.3-1. 


1. 3.1.1  1. 3.2.1 


Figure  2.3-3:  Place  (Placement)  Process  Structure. 
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Table  2.3-1  shows  the  interprocess  messages  generated  and  received  by  the  Place 
I  process. 


Received 

From 

Sent  To 

In  Response  To 

Data  Sent 

Transaction  Type 

SimAllocated 

SCC 

Combat  vehicle 
simulator 
allocated  to 
company  at  SCC 
Console. 

-  identifier 

-  company 

One-way 

interaction 

ActivateVehicle 

Mother 

Activate  or 
reconstitute 
combat  vehicle 
simulator 

-  identifier 

-  reason 
-type 

-  location 

-  alignment 

-  bumper  # 

-  hull  and 
turret 

orientation 

-  supplies  and 
failure  status 

First  part  of  two- 
way  interaction 

SimPlaced 

SCC 

Combat  vehicle 
simulator  placed 
at  SCC  Console 

-identifier 

One-  way 
interaction 

ActivateResult 

Mother 

Placed  combat 
vehicle . 

-  identifier 

-  result 

Second  part  of 
two-way 
interaction 
ActivateVehicle 

Table  2.3-1:  Place  Process  Interprocess  Messages 

The  SimAllocated  message  is  sent  to  the  Place  process  by  the  SCC  process  if  a  combat 
vehicle  simulator  has  been  allocated  to  a  company  at  the  SCC  console.  The  Place  process 
can  then  update  all  of  the  Placement  consoles  accordingly. 

The  ActivateVehicle  is  sent  to  the  Mother  process  by  the  SCC  process  or  the  Place 
process  when  it  wants  to  activate  or  reconstitute  a  vehicle  simulator.  This  message  is  the 
first  pan  of  a  round-trip  interaction  whose  reply  is  an  ActivateResult  message. 

The  SimPlaced  message  is  sent  to  the  Place  process  by  the  SCC  process  if  a  combat 
vehicle  simulator  has  been  placed  at  the  SCC  console.  The  Place  process  can  then  update 
all  the  Placement  consoles  accordingly. 

ActivateResult:  This  message  is  sent  by  the  Mother  process  after  it  has  placed  a  combat 
vehicle  or  CCV  on  the  battlefield.  The  possible  results  are: 

•  success; 

•  simulator  not  in  expected  state; 

•  no  vehicle  ID  available  at  this  time;  or 

•  no  good  place  to  put  the  vehicle  within  a  radius  around  the  given  location. 

Second  level  CSCs  associated  with  the  Placement  process  are: 

Initialization  Software 

Placement  of  Combat  Vehicle  Simulators 
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2.3.1  Initialization  Software 

The  Placement  process  is  spawned  by  the  SCC  process  when  an  exercise  is  started.  The 
Placement  process  normally  sends  terrain  information  to  the  Placement  console 
application.  In  the  event  that  the  Placement  console  application  has  been  restarted,  any 
information  that  the  Placement  process  may  have  on  all  other  combat  simulators  will  be 
sent. 

The  CSU  associated  with  the  Initializing  Software  is  main.c. 


2.3. 1.1  main.c 

/simnet/mcc/Place/main.c 

main.c  contains  the  top-level  code  for  the  Vehicle  Placement  Console  host  process. 

2. 3. 1.1.1  main 

main  is  the  entry  point  to  the  Place  process.  The  function  call  is  main(argc,  argv).  Table 
2.3-2  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

arqc 

int 

Standard  C  type. 

arqv 

pointer  to  pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

reoister  short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

InitializeProcess 

Section  2.21.1.19.1. 

OpenHostSocket 

Section  2.21.1.7.1. 

ActivateConsole 

Section  2.21.1.7.2. 

AlarmsEnabled 

Section  2.21.2.4,4. 

Table  2.3-2:  main  Information. 

2. 3. 1.1. 2  ProcessMessage 

ProcessMessage  processes  a  message  from  another  process,  type  indicates  whether  the 
message  is  a  one-way,  asynchronous  or  sychronous  request,  or  a  response  to  a  previous 
request,  kind  indicates  the  type  of  message  which  has  been  received,  length  indicates  the 
length  of  the  data  in  the  message  received,  data  is  a  pointer  to  the  actual  message  data. 
Information  is  extracted  from  the  message  data  based  on  the  kind  of  message.  The  function 
call  is  ProcessMessage(type,  kind,  length,  data).  Table  2.3-3  describes  the  parameters 
used,  errors  returned  and  functions  called  using  this  function. 
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Parameter 


e 


kind 


lenath 


data 


Parameters 


reoister  pointer  to  char 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Variable 


alarms  Enabled 


Internal  Variables 


e 


reoister  short 


int 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  type. 


Error  Name 


MCC_UNEXPECTED_MESS 

AGE 


Errors 


Reason  for  Error 


Message  of  unexpected  kind. 


Function 


AlarmsEnabled 


ATPTransact 


CloseSocket 


ResetClock 


SimAllocedRemotel 


SimPlacedRemotel 


Calls 


Where  Described 


Section  2.21.2.4.4. 


Section  2.21.1.7.3. 


Section  2.21.2.10.4. 


Section  2.3. 1.1. 5. 


Section  2.3.2. 1.1. 


Section  2.3.2. 1.3. 


Table  2.3-3:  ProcessMessage  Information. 


2.3. 1.1.3  RequestArrived 

RequestArrived  processes  an  ATP  Request,  t,  from  the  Place  Macintosh.  The  function  call 
is  RequestArriv^(t).  Table  2.3-4  describes  the  parameters  used,  errors  returned  and 
functions  called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

ATPGetRequest 

Section  2.21.1.1.5. 

ProcessGridInfoReauest 

Section  2.21.1.16.1. 

ProcessStartRequest 

Section  2.3. 1.1. 4. 

ProcessSimExistsRequest 

Section  2.21.1.25.1. 

ProcessSimQuervRequest 

Section  2.21.1.25.4. 

ProcessSimlnitRequest 

Section  2.21.1.25.2. 

SimPlacedLocally 

Section  2. 3.2. 1.2. 

Table  2.3-4:  RequestArrived  Information. 


2.3. 1.1.4  ProcessStartRequest 


ProcessStartRequest  handles  a  request,  t,  from  the  Macintosh  for  information  about  the 
exercise  participants.  The  function  call  is  ProcessStartR^uest(t).  Table  2.3-5  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

rsp 

register  pointer  to 
PlaceStariResDonse 

/si  mnet/mc/include/Place  .h 

i 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

1  Called  By  1 

Function 

Where  Described 

RequestArrived 

Section  2.3. 1.1 .3. 

Table  2.3-5:  ProcessStartRequest  Information. 


2. 3. 1.1. 5  ResetClock 

ResetClock  tells  the  Macintosh  what  time  it  is.  The  function  call  is  ResetClockQ.  Table 
2.3-6  describes  the  internal  variables  used  and  functions  called  using  this  function. 


Variable 


Internal  Variables 


e 


PlaceClockReauest 


int 


Where  Tvpedef  Declared 


/si  mnet/mcc/include/Piace .  h 


Standard  C  tvoe. 
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1  Calls  I 

Function 

Where  Described 

MacintoshTime 

Section  2.21.1.27.1. 

ATPPut 

Section  2.21.1.7.4. 

- 

Called  By 

Function 

Where  Described 

ProcessMessaae 

Section  2.3. 1.1 .2. 

Table  2.3-6:  ResetClock  Information. 


2.3.2  Placement  of  Combat  Vehicle  Simulators 

After  a  combat  vehicle  simulator  has  been  allocated  to  a  company  at  the  SCC  console,  a 
message  is  sent  to  all  of  the  Placement  processes  indicating  that  Ae  allocation  has  taken 
place.  After  a  combat  vehicle  simulator  has  been  allocated,  it  can  be  placed  by  a 
placement  console. 

The  Placement  process  receives  messages  from  the  SCC  process  when  a  particular 
combat  vehicle  simulator  has  been  placed  at  the  SCC  console.  The  Placement  process 
must  send  a  message  to  the  SCC  process  when  a  combat  vehicle  simulator  has  been 
placed  from  a  Place  console. 

The  CSU  associated  with  this  second  level  CSC  is  sim.c. 


2.3.2. 1  sim.c 

/simnet/mcc/Place/sim.c 

sim.c  contains  routines  to  implement  the  control  of  vehicle  simulators  from  the  SIMNET 
Placement  Console. 

2. 3. 2. 1.1  SimAllocedRemotely 


SimAllocedRemotely  processes  a  notification,  msg,  from  the  SCC  process  that  a  simulator 
has  been  allocated  to  a  company.  The  function  call  is  SimAilocedRemotely(msg).  Table 
2.3-7  describes  the  parameters  used  and  functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

msg 

pointer  to  MCCMessageBuffer 

/simnet/mc/include/MCC  ipc. 
h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

req 

SimAllocRequest 

/simnet/mc/include/sim  xact.h 

i 

short 

Standard  C  type. 

I  Calls  I 

Function 

Where  Described 

ATPPut 

Section  2.21.1.7.4. 
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Table  2.3-7:  SimAllocedRemotely  Information. 

2. 3. 2. 1.2  SimPlacedLocally 

SimPIacedLocally  tells  the  Placement  console  host  process  that  the  SCC  console  has  been 
used  to  place  a  vehicle,  vehicle.  The  function  call  is  SimPlacedLocally(vehicle).  Table 
2.3-8  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


vehicle 


variable 


msg 


IDTH 


Internal  Var  ables 


e 


MCCMessageBuffer 


Where  Tvoedef  Declared 


Standard  C  type. 


Where  Tvoedef  Declared 


/simnet/mcc/include/MCCJpc 

■h 


Function 


SimPlacedRemotel 


SendMCCMsat 


Calls 


Where  Described 


Section  2.3.2.I.3. 


Macro  defined  in  /simnet/mcc/include/MCC 


Called  B 


Function 

Where  Described 

RequestArrived 

Section  2.3.1. 1.3. 

Table  2.3-8:  SimPlacedLocally  Information. 

2. 3. 2. 1.3  SimPiacedRemotely 

SimPlacedRemotely  tells  the  Placement  consoles  that  a  certain  simulator,  specified  by 
vehicle,  has  been  activated  from  another  Placement  console.  The  function  call  is 
SimPlacedRemotely(vehicle).  Table  2.3-9  describes  the  parameters  used  and  functions 
called  using  this  function. 


Parameters 


Parameter 


vehicle 


Where  Tvoedef  Declared 


Standard  C  t 


Internal  Variables 

Variable 

Tvoe 

Where  Typedef  Declared 

Sim 

register  pointer  to 
SimulatorStatus 

/simnet/mcc/include/veh_tabl 

e.h 

req 

SimPlacedRequest 

/simnetimcc/include/sim  xact. 
h 

Standard  C  type. 
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1  Calls  1 

Function 

Where  Described  I 

ATP  Put 

Section  2.21.1.7.4.  I 

Called  By 

Function 

Where  Described 

ProcessMessaae 

Section  2.3. 1.1. 2. 

SimPlacedLocally 

Section  2.3.2. 1.2. 

Table  2.3-9: 


SimPIacedRemotely  Information. 
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It  sends  out  two  PDUs,  Resupply  Offer  and  Resupply  Cancel.  It  sends  and  receives  the 
interprocess  messages  listed  in  Table  2.4-1. 


Interprocess 

Message 

Received 

From 

Sent  To 

In  Response  To 

Data  Sent 

Transaction  Type 

ShowCCV 

Mother 

cev  needs  to  be 
visible 

-ownership 

-identifier 

-type 

-alignment 

-role 

-company 

-location 

-direction 

First  part  of  two- 
way  interaction 

HideCCV 

Mother 

cev  needs  to  be 
invisible 

-  indentifier 

One-way 

interaction 

KilledCCV 

Mother 

When  cev  killed 
as  shown  by 
these  PDUs: 
Vehicleimpact 
Collision 

Indirect  Fire 

-  identifier 

One-way 

interaction 

Truck 

Reconstitute 

see 

Supply  truck  or 

maintenance 

team 

reconstituted 

-  identifier 
-type 

-  location 

-  supplies 

-  company 

-  force 

One-way 

interaction 

DepotDisplace 

sec 

BattleMaster  has 
displaced 
ammunition  or 
fuel  depots 

One-way 

Interaction 

ServiceRequest 

Mother 

Service  Request 
PDU  received 
from  combat 
vehicle  simulator 

-truck 
identifier 
-  combat 
vehicle 
identifier 

One-way 

Interaction 

Vehicle 

Resupplied 

Mother 

Resupply 
Received  PDU 
from  combat 
vehicle  simulator 

-truck 

identifier 

-  combat 
vehicle 
identifier 

-  amount  of 
fuel  taken 

-  amount  of 
ammo  taken 

One-way 

interaction 

Resupply 

Cancel 

Mother 

Resupply  Cancel 
PDU  from 
combat  vehicle 
simulator 

-truck 

identifier 

-combat 

vehicle 

identifier 

One-way 

interaction 

Table  2.4'1:  Admin  Process  Interprocess  Messages. 
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It  consists  of  the  following  second  level  CSCs: 

Initialization  and  Communication 

Truck  Dispatching 

Servicing 


2.4.1  Initialization  and  Communication 

The  Admin  Process  opens  a  connection  with  the  Admin  Mac  and  then  sends  down  the 
initial  location  of  all  the  ammo  and  fuel  trucks.  It  listens  to  messages  from  the  Mother 
process  such  as  when  a  truck  is  killed  and  passes  that  information  along  to  the  Macintosh. 
It  listens  to  messages  from  the  Mac  indicating  when  a  truck  is  being  dispatched  or  is 
transferring  supplies,  etc.  It  contains  one  CSU,  main.c. 


2.4. 1.1  main.c 

/simnet/mcc/Admin/main.c 

main.c  contains  the  top  level  code  for  the  Admin/Log  Console  host  process.  Table  2.4-2 
shows  variables  used  by  main.c. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

m977State[ 

array  numberBnM977Vehicles 
of  TruckState 

/simnet/mcc/Admin/Adminhos 

t.h 

m978State 

array  numberBnM978Vehicles 
of  TruckState 

/simnet/mcc/Admin/Adminhos 

t.h 

Table  2.4-2:  main  Variable  Information. 


2. 4. 1.1.1  main 

main  is  the  entry  point  to  the  Admin/Log  process.  The  function  call  is  main(argc,  argv). 
Table  2.4-3  describes  the  parameters  us^  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

argc 

int 

Standard  C  type. 

arqv 

pointer  to  pointer  to  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

InitializeProcess 

Section  2.21.1.19.1. 

InitializeResuppty 

Section  2.4.3. 1.1. 

OpenHostSocket 

Section  2.21.1.7.1. 

ActivateConsole 

Section  2.21.1.7.2. 

AlarmsEnabled 

Section  2.21.2.4,4. 

Table  2.4-3;  main  Information. 
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2. 4. 1.1. 2 


ProcessMessage 


ProcessMessage  processes  a  message  from  another  process,  type  indicates  whether  the 
message  is  a  one-way,  asynchronous  or  sychronous  request,  or  a  response  to  a  previous 
request  land  indicates  the  type  of  message  which  has  been  received,  length  indicates  the 
length  of  the  data  in  the  message  received,  data  is  a  pointer  to  the  actual  message  data. 
Information  is  extracted  from  die  message  data  based  on  the  kind  of  message.  The  function 
call  is  ProcessMessage(type,  kind,  length,  data).  Table  2.4-4  describes  the  parameters 
used,  errors  returned  and  functions  called  using  this  function. 


1  Parameters  I 

1  Parameter  I 

Where  Tvoedef  Declared 

int 

Standard  C  type. 

kind 

long 

Standard  C  type. 

length 

int 

Standard  C  type. 

data 

pointer  to  char 

Standard  C  type. 

internal  Variables 

Variable 

Where  Tvoedef  Declared 

alarmsEnabled 

int 

Standard  C  type. 

1  Errors  1 

Error  Name 

Reason  for  Error 

MCC  UNEXPECTED  MESS 
AGE 

Message  of  unexpected  kind. 

1  Calls  1 

Function 

Where  Described 

AlarmsEnabled 

Section  2.21.2.4.4. 

ATPTransact 

Section  2.21.1.7.3. 

CloseSocket 

Section  2.21.2.10.4. 

ResetClock 

Section  2.4. 1.1. 3. 

TruckKilled 

Section  2.4. 2. 1.5. 

SendDepotRequest 

Section  2. 4.1. 1.6. 

ServiceRequest 

Section  2.4. 3. 1.2. 

VehicleResupplied 

Section  2.4  3.1.3. 

CancelResupply 

Section  2.4.3. 1.4. 

ReconstituteTruck 

Section  2  4.2.1.2. 

Table  2.4-4:  ProcessMessage  Information. 

2. 4. 1.1. 3  ResetClock 

ResetClock  updates  the  clock  on  the  Macintosh.  The  function  call  is  ResetClock().  Table 
2.4-5  describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

req 

AdminLoqClockRequest 

/simnet/mcc/include/ Admin. h 

1  n 
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1  Calls  1 

Function 

Where  Described 

MacintoshTime 

Section  2.21.1.27.1. 

ATPPut 

Section  2.21.1.7.4. 

Called  By 

Function 

Where  Described 

ProcessMessaqe 

Section  2.4. 1.1. 2. 

Table  2.4-5:  ResetClock  Information. 


2.4. 1.1.4  RequestArrived 


RequestAnived  processes  an  ATP  Request,  t,  from  the  Admin/Log  Macintosh.  The 
function  call  is  RequestArrived(t).  Table  2.4-6  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

Errors 

Error  Name 

Reason  for  Error 

MCC  GETREQUEST  FAILE 

D 

ATPGetRequest  failed. 

MCC  UNKNOWN  REQUEST 

Unknown  request  from  Macintosh. 

Calls 

Function 

Where  Described 

ATPGetRequest 

Section  2.21.1.1.5. 

ProcessGridInfoRequest 

Section  2.21.1.16.1. 

SendForceRequest 

Section  2.4. 1.1. 5. 

InitializeAllTrucks 

Section  2.4. 1.1. 7. 

TruckDispatched 

Section  2.4.2. 1.4. 

TruckArrived 

Section  2  4.2.1.3. 

Table  2.4-6:  RequestArrived  Information. 
2. 4. 1.1. 5  SendForceRequest 


SendForceRequest  downloads  the  battalion  and  company  ForcelDs  to  the  Macintosh.  The 
function  call  is  SendForceRequest().  Table  2.4-7  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

req 

AdminLoqForceRequest 

/simnet/mcc/i  nclude/ Ad  mi  n .  h 

i 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

ATPPut 

Section  2.21.1.7,4. 
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Called  B 


Function 

Where  Described 

RequestArrived 

Section  2.4. 1.1. 4. 

Table  2.4-7:  SendForceRequest  Information. 

2. 4. 1.1. 6  SendDepotRequest 

SendDepotRequest  downloads  the  depot  locations  to  the  Macintosh.  The  function  call  is 
SendDepotRequest ().  Table  2.4-8  describes  the  internal  variables  used,  errors  returned  and 
functions  called  using  this  function. 


Variable 


Internal  Variables 


e  Where  Tvpedef  Declared 


AdminLoaOeDotRequest  I  /simnet/mcc/mclude/Admm.h 


Calls 

Function 

Where  Described 

ATPPut 

Section  2.21.1.7.4. 

Called  B 


Function 

Where  Described 

InitializeAllTrucks 

Section  2.4. 1.1. 7. 

ProcessMessaqe 

Section  2.4. 1.1. 2. 

Table  2.4-8:  SendDepotRequest  Information. 

2. 4. 1.1. 7  InitializeAllTrucks 

InitializeAllTrucks  ships  initial  parameters  to  the  Macintosh.  The  function  call  is 
InitializeAllTrucksO.  Table  2.4-9  describes  the  internal  variables  used  and  functions  called 
using  this  function. 


Variable 


state 


Internal  Variables 


e  Where  Tvpedef  Declared 


register  pointer  to  TruckState  /simnet/mcc/Admirv/Adminhos 

t.h 


register  unsiqned  short  I  Standard  C  type. 


AdminSuPDliesReauest  /simnet/mcc/include/Admin.h 


Function 


InitializeTruck 


SendDepotRequest 


ATPPut 


Calls 


Where  Described 


Section  2.4. 2. 1.1. 


Section  2.4. 1.1. 6. 


Section  2.21.1.7.4. 


Called  B 


Function 

Where  Described 

RequestArrived 

Section  2.4. 1.1. 4. 

Table  2.4-9:  InitializeAllTrucks  Information. 
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2. 4. 1.1. 8  LookupTruckNumber 

LookupTruckNumber  finds  a  truck  state  recoixi  given  truckNumber  and  capabilities.  The 
function  call  is  LookupTruckNumber( truckNumber,  capabilities).  Table  2.4-10  describes 
the  parameters  used  by  this  function. 


Parameters 


Parameter 


truckNumber 


capabilities 


IEI7I! 


mt 


vehicleCapabilities 


Where  Tyoedef  Declared 


Standard  C  tvoe. 


/si  mnet/co  mmon/i  nclude/prot 
ocol/basic.h 


Return  Values 


Return  Value  Type  _ 


&m977State[truckNumber]  pointer  to  TruckState 


&m978State[truckNumber]  pointer  to  TruckState 


Meaning 


data  which  describes  the 
ammo  truck  indexed  by 
taickNumber 


data  which  describes  the  fuel 
truck  indexed  bv  truckNumber 


Function 


Reconstitute! ruck 


TruckArrived 


TruckDisoatched 


Called  B 


Where  Described 


Section  2.4.2. 1.2. 


Section  2.4.2. 1.3. 


Section  2.4. 2. 1.4. 


Table  2.4*10:  LookupTruckNumber  Information. 

2.4. 1.1.9  LookupCCVNumber 

LookupCCVNumber  finds  a  CCV  state  record,  specified  by  ccvNumber.  Given  the  CCV 
number  of  the  vehicle,  return  the  data  which  corresponds  to  it.  CCV  numbers  are  unique 
among  all  MCC  vehicles.  The  function  call  is  LookupCCVNumber(ccvNumber).  Table 
2.4-1 1  describes  the  parameters  used  by  this  function. 


Parameter 


ccvNumber 


Parameters 


Where  Tvoedef  Declared 


Standard  C  tvoe. 


Return  Values 


Return  Value 

Type 

Meaning 

&m977State[ccvNumber  - 
firstBnM977Vehiclel 

int 

the  CCV  state  record 

&m978State[ccvNumber  - 
firstBnM978Vehiclel 

int 

the  CCV  state  record 
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1  Called  By  1 

Function 

Where  Described 

TruckKilled 

Section  2  4.2.1.5. 

ServiceRequest 

Section  2.4.3. 1.2. 

VehicleResupplied 

Section  2  4.3.1.3. 

CancelResupply 

Section  2.4.3. 1.4. 

Table  2.4-11:  LookupCCVNumber  Information. 


2.4.2  Truck  Dispatching 

When  Admin  receives  a  message  from  the  Mac  indicating  a  truck  is  to  be  moved,  Admin 
sends  a  message  to  Mother  to  deactivate  the  tmck.  The  Admin  Mac  sends  another  message 
when  it's  time  for  a  truck  to  anive  at  its  destination.  The  Admin  Process  sends  a  message 
to  Mother  to  place  the  CCV  again  at  its  new  location.  The  only  CSU  is  displace.c. 


2. 4. 2.1  displace.c 

/simnet/mcc/Admin/displace.c 

displace.c  contains  routines  for  placing  and  displacing  trucks  controlled  from  the 
Admin/Log  Console. 

2. 4. 2. 1.1  InitializeTruck 


InitializeTruck  downloads  the  initial  parameters  for  a  single  truck  to  the  Macintosh,  state 
points  to  a  local  structure  which  contains  more  information  on  the  truck;  pars  is  the  data 
structure  in  shared  memory  which  holds  some  information  on  the  truck.  The  function  call 
is  lnitializeTruck(state,  pars).  Table  2.4-12  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

state 

register  pointer  to  TruckState 

/simnet/mcc/Admin/Adminhos 

t.h 

pars 

pointer  to  TruckParameters 

/simnet/mcc/include/MCC  jaar 
s.h 

internai  Variabies 

Variable 

Type 

Where  Typedef  Declared 

req 

AdminLoqTruckRequest 

/Sim  net/mcc/i  nclude/ Ad  mi  n .  h 

guises 

VehicleGuises 

/simnet/common/include/prot 

ocol/basic.h 

Calls 

Function 

Where  Described 

RestoreTruck 

Section  2.4.2. 1.6. 

GetGuises 

Section  2.21.1.17.1. 

DisplayCCV 

Section  2.21.1.6.1. 

ATPTransact 

Section  2,21.1.7.3. 

1  1 
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Function 


ReconstituteTruck 


Initialize  AIITrucks 


Called  B 


Where  Described 


Section  2.4. 2. 1.2. 


Section  2.4. 1.1. 7. 


Table  2.4-12:  InitializeTruck  Information. 

2.4.2. 1.2  ReconstituteTruck 

ReconstituteTruck  is  called  to  reset  a  truck  to  the  ready  state  with  new  position,  load  and 
company  assignments,  msg  contains  the  truck’s  vehicle  number,  its  capabilities,  a 
location,  and  the  organization.  The  function  call  is  ReconstituteTruck(msg).  Table  2.4-13 
describes  the  parameters  used  and  functions  called  using  this  function. 


Variable 


state 


Internal  Variables 


e 


Where  Tvoedef  Declared 


register  pointer  to  TruckState  /simnet/mcc/Admin/Adminhos 

t.h 


register  pointer  to 
TruckParameters 


/simnet/mcc/include/MCC_par 

.h 


Function 


Lookup!  ruckNumber 


Get!  ruckParameters 


Lock 


Unlock 


InitializeTruck 


Calls 


Where  Described 


Section  2.4.1. 1.8. 


Section  2.21.1.29.1. 


Section  2.21.2.6.3. 


Section  2.21.2.6.4. 


Section  2  4.2.1.1. 


Called  B 


Function 

Where  Described 

ProcessMessaqe 

Section  2.4.1. 1.2. 

Table  2.4-13:  ReconstituteTruck  Information. 

2.4.2. 1.3  Truck  Arrived 

TruckArrived  is  called  when  a  truck  arrives  at  its  destination,  t  contains  an 
AdminLogArriveRequest  which  holds  information  about  the  truck  such  as  its  fleet,  its 
vehicle  number,  and  its  load  of  ammunition.  The  function  call  is  TruckArrived(t).  Table 
2.4-14  describes  the  parameters  used  and  functions  called  using  this  function. 
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1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

state 

pointer  to  TruckState 

/simnet/mcc/Admin/Adminhos 

t.h 

pars 

pointer  to  TruckParameters 

/simnet/mcc/include/MCCjjar 

s.h 

req 

pointer  to 

AdminLoqArriveRequest 

/simnet/mcc/include/ Admin. h 

rsp 

pointer  to 

AdminLoqArriveResponse 

/simnet/mcc/include/ Admin. h 

guises 

VehicleGuises 

/simnet/common/include/prot 

ocol/basic.h 

capabilities 

VehicleCapabilities 

/simnet/comnrK>n/include/prot 

ocol/basic.h 

1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

TurnFleetIntoCapabilities 

Section  2.4.2. 1.7. 

LookupTruckNumber 

Section  2.4. 1.1. 8. 

GetT  ruckParameters 

Section  2.21.1.29.1. 

Lock 

Section  2.21.2.6.3. 

Unlock 

Section  2.21.2.6.4. 

RestoreTruck 

Section  2.4. 2. 1.6. 

GetGuises 

Section  2.21.1.17.1. 

DisplavCCV 

Section  2.21.1.6.1. 

SendConsoleResponse 

Section  2.21.1.7.6. 

1  Called  Bv  1 

Function 

Where  Described 

RequestArrived 

Section  2.4. 1.1. 4. 

Table  2.4-14:  TruckArrived  Information. 


2.4.2. 1.4  TruckDispatched 

TruckDispatched  is  called  when  a  truck  has  been  dispatched,  t  contains  fleet  and  vehicle 
number  of  the  truck  to  dispatch.  The  function  call  is  TruckDispatched(t).  Table  2.4-15 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


Parameters 


inter  to  Transaction 


Where  Tvoedef  Declared 


/simnet/mcc/mclude/bndoe.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

req 

pointer  to 

AdminLoqDisoatchRequest 

/simnet/mcc/include/ Admin. h 

state 

register  pointer  to  TruckState 

/simnet/mcc/Admin/Adminhos 

t.h 

capabilities 

VehicleCapabilities 

/simnet/comrrwn/include/prot 

ocol/basic.h 
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1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

TurnFleetIntoCapabilities 

Section  2.4.2. 1.7. 

LookupTruckNumber 

Section  2.4. 1.1 .8. 

SendConsoleResponse 

Section  2.21.1.7.6. 

RestoreTruck 

Section  2.4.2.I.6. 

HideCCV 

Section  2.21.1.6.2. 

Called  By 

Function 

Where  Described 

RequestArrived 

Section  2.4. 1.1. 4. 

Table  2.4-15:  TruckDispatched  Information. 


2. 4. 2. 1.5  TruckKilled 

TruckKilled  is  called  when  a  truck  has  been  destroyed,  msg  is  the  CCV  number  of  the 
truck  killed.  The  function  call  is  TruckKilled(msg).  Table  2.4-16  describes  the  parameters 
used  and  functions  called  using  this  function. 


Parameter 


msg 


Parameters 


e  Where  Tvoedef  Declared 


pointer  to  MCCMessageBuffer  /simnet/mcc/include/MCCJpc 

•h 


Internal  Variables 

Variable 

Where  Tvpedef  Declared 

state 

register  pointer  to  TruckState 

/simnet/mcc/ Admin/ Adminhos 
t.h 

AdminLooKilledRequest 


/simnet/mcc/include/Admin.h 


Function 


LookupCCVNumber 


ResloreTruck 


ATPPut 


Calls 


Where  Described 


Section  2.4. 1.1. 8. 


Section  2.4.2.I.6. 


Section  2.21.1.7.4. 


Called  B 


Function 

Where  Described 

ProcessMessaqe 

Section  2.4.1. 1.2. 

Table  2.4-16:  TruckKilled  Information. 


2. 4. 2. 1.6  RestoreTruck 


RestoreTruck  is  called  when  a  truck  is  stationary,  visible,  healthy  and  alone.  The  function 
call  is  RestoreTruck(state).  Table  2.4-17  describes  the  parameters  used  and  functions 
called  using  this  function. 
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1  Parameters  I 

Parameter 

Where  Typedef  Declared 

state 

register  pointer  to  TruckState 

/simnet/mcc/Admin/Adminhos 

t.h 

* 

Calls 

Function 

Where  Described 

CancelAlarm 

Section  2.21.2.4.3. 

CancelOffers 

Section  2.4.3. 1.6. 

1  Called  Bv  1 

Function 

Where  Described 

TruckDispatched 

Section  2.4. 2.1. 4. 

TruckKilled 

Section  2.4.2.I.5. 

InitializeTruck 

Section  2.4. 2. 1.1. 

TruckArrived 

Section  2.4.2. 1.3. 

Table  2.4-17:  RestoreTruck  Information. 

2. 4. 2. 1.7  TurnFleetIntoCapabilities 

TumFleetIntoCapabilities  fills  in  the  proper  fields  of  a  capabilities  structure  from  a  fleet 
type,  where  fleet  is  ammunition,  fuel,  pallet,  or  maintenance;  cap  is  a  vehicle  capabilities 
structure  that  marks  TRUE  with  all  the  capabilities  of  the  truck.  The  function  cdl  is 
TumFleetIntoCapabilities(fleet,  cap).  Table  2.4-18  describes  the  parameters  used  by  this 
function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

fleet 

int 

Standard  C  type. 

cap 

pointer  to  VehicieCapabilities 

/simnet/common/include/prot 

ocol/basic.h 

Called  By 

Function 

Where  Described 

T  ojckArrived 

Section  2.4. 2. 1.3. 

TruckDispatched 

Section  2.4. 2. 1.4. 

Table  2.4-18:  TurnFleetIntoCapabilities  Information. 


2.4.3  Servicing 

Admin  receives  messages  from  Mother  when  a  combat  vehicle  is  close  enough  to  a  tmck 
and  needs  to  be  resupplied  with  fuel  or  ammo.  Admin  changes  the  internal  state  of  the 
truck  to  servicing  and  sends  out  packets  which  offer  fuel  or  ammo.  The  combat  vehicle 
sends  messages  via  Mother  describing  how  much  fuel  or  ammo  was  taken.  Admin  then 
propagates  the  information  to  the  Admin  Mac  so  it  can  decrement  the  truck  load.  This 
functionality  is  realized  by  the  CSU  service.c. 
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2.4.3. 1  service^c 
/simnet/mcc/Admin/sendce.c 

service.c  contains  routines  which  implement  the  servicing  of  the  vehicles  by  the  Admin/Log 
tracks.  Table  2.4-19  describes  the  variables  used  by  service.c. 


Variables 


Variable 


roSimPDU 


rcSimPDU 


rofferPDU 


rcancelPDU 


newAmmoType 


networkinterface 


staticSimulationPOU 


staticSimulationPOU 


Where  Tvoedef  Declared 


/simnet/common/include/prot 
ocol/D  sim.h 


/simnet/common/include/prot 
ocol/D  sim.h 


pointer  to  ResupplyVariant  /simnet/common/include/prot 

ocol/D  sim.h 


pointer  to  ResupplyVariant  /simnet/common/include/prot 

ocol/D  sim.h 


/simnet/common/include/prot 

ocol/basic.h 


Standard  C  tvoe. 


array  of  ObjectType 


extern  int 


Table  2.4-19:  service.c  Variable  Information. 

2. 4. 3. 1.1  InitializeResupply 

InitializeResupply  initializes  the  resupply  package.  The  function  call  is 
InitializeResupplyO.  Table  2.4-20  describes  this  function. 


Function 


main 


Called  B 


Where  Described 


Section  2.4. 1.1.1. 


Table  2.4-20:  InitializeResupply  Information. 

2. 4. 3. 1.2  ServiceRequest 

ServiceRequest  is  called  when  a  combat  vehicle  wants  service  from  a  track,  as  indicated  by 
msg.  The  function  call  is  ServiceRequest(msg).  Table  2.4-21  describes  the  parameters 
used  and  functions  called  using  this  function. 
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Internal  Variables 

Variable 

Where  Typedef  Declared 

state 

register  pointer  to  TruckState 

/simnet/mcc/Admin/Adminhos 

t.h 

lenath 


msgl 


pointer  to  TruckParameters 


reoisler  unsioned  short 


register  pointer  to  struct  client 


pointer  to  MunitionOuantity 


unsigned  char 


short 


short 


AdminLogServicingReauest 


MCCMessageBuffer 


Standard  C  type. 


/simnet/mcc/Admin/Admmhos 

t.h 


/simnet/common/include/prot 

ocol/basic.h 


Standard  C  t 


Standard  C  type. 


Standard  C  t 


/simnet/mcc/include/ Admin. h 


Standard  C  type. 


/si  mnet/mcc/i  nclu .  'e/M  CCJpc 
h 


Calls 

Function 

Where  Described 

LookupCCVNumber 

Section  2.4. 1.1. 9. 

GetTruckParameters 

Section  2.21.1.29.1. 

CancelAlarm 

Section  2.21.2.4.3. 

ATPPut 

Section  2.21.1.7.4 

SetAlarm 

Section  2.21.2.4.2. 

PRO  SIM  RESUPPLY  OFF 
ER  SIZE 

p_size.h 

SendMCCMsgl 


AssocSendDatagram 


Macro  defined  in  /simnet/mcc/include/MCC  i 


Section  2.20.1.2.1. 


Function 


ProcessMessaoe 


Called  B 


Where  Described 


Section  2. 4. 1.1. 2. 


Table  2.4-21;  ServiceRequest  Information. 

2.4.3. 1.3  VehicleResupplied 

VehicleResupplied  is  called  when  a  vehicle  has  accepted  supplies  that  have  been  offered,  as 
indicated  by  msg.  The  function  call  is  VehicleResupplied(msg).  Table  2.4-22  describes 
the  parameters  used,  errors  returned  and  functions  called  using  this  function. 


Parameter 


msg 


Parameters 


e  Where  Tvpedef  Declared 


pointer  to  MCCMessageBuffer  /simnet/mcc/include/MCCJpc 

h 
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1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

state 

register  pointer  to  TruckState 

/simnet/mcc/Admin/Adminhos 

t.h 

pars 

pointer  to  TruckParameters 

/simnet/rTxx::/include/MCC_par 

s.h 

i 

reqister  unsiqned  short 

Standard  C  type. 

client 

register  pointer  to  struct  client 

/simnet/mcc/Admin/Adminhos 

t.h 

req 

AdminLoqT  ransferRequest 

/simnet/mcc/include/Admin.h 

Errors 

Error  Name 

Reason  for  Error 

MCC  UNEXPECTED  PACK 
ET 

Unexpected  packet  type.  There  is  no  truck  expecting  a 
resupply  from  the  requestinq  vehicle. 

MCC  TOO  MUCH  AMMO  T 
AKEN 

Took  more  ammo  than  offered. 

MCC  TOO  MUCH  FUEL  TA 
KEN 

Took  more  fuel  than  offered. 

Calls 

Function 

Where  Described 

LookuoCCVNumber 

Section  2. 4. 1.1. 9. 

GetT  ruckParameters 

Section  2,21.1.29.1. 

CancelAlarm 

Section  2.21.2.4.3. 

RemoveClient 

Section  2.4  3.1.7. 

ATPPut 

Section  2.21.1.7.4. 

Called  By 

Function 

Where  Described 

ProcessMessaqe 

Section  2  4.1.1.2. 

Table  2.4-22:  VehicleResupplied  Information. 


2. 4. 3. 1.4  CancelResupply 

CancelResupply  is  called  when  a  Resupply  Cancel  PDU  is  received  from  a  client  which 
indicates  that  a  resupply  process  is  to  halt,  msg  holds  a  resupply  structure  which  contains 
the  id  of  the  client  requesting  the  supplies.  The  function  call  is  CancelResupply(msg). 
Table  2.4-23  describes  the  parameters  used,  errors  returned  and  functions  called  using  this 
function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

msg 

pointer  lo  MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
h 
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Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

state 

register  pointer  to  TruckState 

/simnet/mcc/Admin/Adminhos 

t.h 

reqister  unsiqned  short 


register  pointer  to  struct  client 


AdminLoqTransferRequest 


Standard  C  t 


/simnet/mcc/Admin/Adminhos 

t.h 


/simnet/mcc/include/Admin.h 


Error  Name 


MCC_UNEXPECTED_PACK 

ET 


Errors 


Reason  for  Error 


Unexpected  packet  type.  There  was  no  tmck  that  thought  it 
was  in  a  resupply  transaction  with  this  client. 


Function 


LookupCCVNumber 


GetTruckParameters 


CancelAlarm 


WithdrawOffer 


Calls 


Where  Described 


Section  2.4. 1.1. 9. 


Section  2.21.1.29.1. 


Section  2.21.2.4.3. 


Section  2.4.3. 1.5. 


Called  B 


Function 

Where  Described 

ProcessMessaqe 

Section  2.4.1. 1.2. 

Table  2.4-23:  CancelResuppIy  Information. 

2.4.3. 1.5  WithdrawOffer 

WithdrawOffer  cancels  an  offer  to  a  client,  state  is  the  structure  describing  the  truck  that 
was  providing  the  supply;  client  is  the  structure  describing  the  vehicle  receiving  the  supply. 
The  function  call  is  WithdrawOffer(state,  client).  Table  2.4-24  describes  the  parameters 
used  and  functions  called  using  this  function. 


Parameter 


state 


Parameters 


register  pointer  to  TmckState 


Where  Typedef  Declared 


/si  m  net/mcc/ Admi  n/ Ad  mi  n 
host.h 


register  pointer  to  struct  client  /simnet/mcc/ Admin/ Admin 

host.h 


Variable 


Internal  Variables 


e 


reqister  unsiqned  short 


Where  Tvoedef  Declared 


Standard  C  type. 


Function 


RemoveClient 


Calls 


Where  Described 


Section  2.4.3. 1.7. 
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1  Called  By  1 

Function 

Where  Described 

ServiceTimeout 

Section  2  4.3.1.8. 

CancelResuDPlv 

Section  2.4.3. 1.4. 

Table  2.4-24:  WithdrawOffer  Information. 


2.4.3. 1.6  CancelOffers 

CancelOffers  cancels  all  outstanding  offers  of  supplies,  state  is  the  structure  describing  the 
truck  that  was  providing  the  supply.  The  function  call  is  CancelOffers(state).  Table  2.4-25 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

state 

register  pointer  to  TruckState 

/si  mnet/mcc/Admi  n/Admi  n 
host.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

client 

register  pointer  to  struct  client 

/si  mnet/mcc/Admi  n/ Ad  mi  n 
host.h 

Calls 

Function 

Where  Described 

AssocSendDataqram 

Section  2.20.1.2.1. 

PRO  SIM  RESUPPLY  CAN 
CEL  SIZE 

p_size.h 

CancelAlarm 

Section  2.21.2.4.3. 

Called  By 

Function 

Where  Described 

RestoreTruck 

Section  2.4. 2. 1.6. 

Table  2.4-25:  CancelOffers  Information. 


2. 4. 3. 1.7  RemoveClient 

RemoveClient  removes  a  client  from  the  list  of  clients  maintained  for  a  particular  service 
truck,  state  is  the  structure  describing  the  truck  that  was  providing  the  supply;  client  is  the 
structure  describing  the  vehicle  receiving  the  supply.  The  function  call  is 
RemoveClient(state,  client).  Table  2.4-26  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

state 

register  pointer  to  TruckState 

/si  mnet/mcc/Admi  n/Admi  n 
host.h 

client 

register  pointer  to  struct  client 

/si  mnet/mcc/Admi  n/ Admin 
host.h 
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1  Calls  1 

Function 

Where  Described 

SetAlarm 

Section  2.21.2.4.2. 

Called  By 

Function 

Where  Described 

WithdrawOffer 

Section  2  4.3.1.5. 

VehicleResupplied 

Section  2  4.3.1.3. 

Table  2.4-26:  RemoveClient  Information. 


2. 4. 3. 1.8  ServiceTimeout 

ServiceTimeout  creates  a  one  minute  timeout  on  an  outstanding  Resupply  Offer  PDU. 
param  contains  the  TnickState  of  the  turck  offering  the  supplies;  a  is  the  alarm  which 
initiated  this  call.  The  function  call  is  ServiceTimeout(param,  a).  Table  2.4-27  describes 
the  parameters  used,  errors  returned  and  functions  call^  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

param 

long 

Standard  C  type. 

a 

Alarm 

/si  mnet/rcs/libipc/alarm.  h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

state 

pointer  to  TruckState 

/si  mnet/mcc/ Admi  n/ Admi  n 
host.h 

i 

register  unsigned  short 

Standard  C  type. 

client 

register  pointer  to  struct  client 

/si  mnet/mcc/ Admi  n/ Ad  mi  n 
host.h 

1  Errors  1 

Error  Name 

Reason  for  Error 

MCC  INCONSISTENCY 

Internal  inconsistency. 

1  Calls  1 

Function 

Where  Described 

AssocSendDataqram 

Section  2.20.1.2.1. 

PRO  SIM  RESUPPLY  CAN 
CEL  SIZE 

p_size.h 

WithdrawOffer 

Section  2.4.3.I.5. 

Table  2.4-27:  ServiceTimeout  Information. 


2. 4. 3. 1.9  ReadyTimeout 

ReadyTimeout  returns  a  truck  to  ready  state  when  no  additional  ServiceRequest  PDUs 
seem  to  be  forthcoming,  param  contains  the  TruckState  of  the  truck  offering  the  supplies;  a 
is  the  alarm  which  initiated  this  call.  The  function  call  is  ReadyTimeout(param,  a).  Table 
2.4-28  describes  the  parameters  used  and  functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Where  Typedef  Declared 

oaram 

Iona 

Standard  C  type. 

a 

Alarm 

/simnet/rcs/libipc/alarm.h 

Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

state 

pointer  to  TruckState 

/simnet/mcc/ Admin/ Admin 
host.h 

req 

AdminLoqServicinqRequest 

/Sim  net/mcc/i  nclude/Admi  n .  h 

1  Calls  1 

Function 

Where  Described 

ATPPut 

Section  2.21.1.7.4. 

Table  2.4-28: 


ReadyTimeout  Information. 
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2.5  The  Maint  (Maintenance)  Process 

The  Maint  process  is  used  to  control  a  fleet  of  maintenance  vehicles.  All  of  the  maintenance 
vehicles  are  currently  represented  by  2  1/2  ton  trucks,  even  though  they  occasionally  are 
used  to  recover  vehicles.  The  maintenance  vehicles  can  perform  repairs  on  up  to  three 
vehicles  at  one  time  and  can  be  moved  and  destroyed  like  other  CCVs.  The  structure  of 
Maint  process  is  shown  in  Figure  2.5-1. 


Maint  (Maintenance)  Process 
1.5 


Initializing 

Truck 

and 

Dispatch 

Communications 

1.5.2 

1.5.1 

1 

—  main.c 

~  displace.c 

Servicing 

1.5.3 


1.5. 1.1 


1. 5.2.1  1. 5.3.1 


Figure  2.5-1:  Maint  (Maintenance)  Process  Structure. 
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The  Maint  Process  CSC  sends  and  receives  the  interprocess  messages  listed  in  Table  2.5-1. 


Received 

From 

Sent  To 

In  Response  To 

Data  Sent 

Transaction  Type 

ShowCCV 

Mother 

eev  needs  to  be 
visible 

-ownership 

-identifier 

-type 

-alignment 

-role 

-company 

-location 

-direction 

First  part  of  two- 
way  interaction 

HideCCV 

Mother 

eev  needs  to  be 
invisible 

-  indentifier 

One-way 

interaction 

KilledCCV 

Mother 

When  eev  killed 
as  shown  by 
these  PDUs: 
Vehicleimpact 
eollision 

Indirect  Fire 

-  identifier 

One-way 

interaction 

ActivateVehicle 

Mother 

Reactivate 
vehicle  when  at 
towing 
destination 

-  identifier 

-  reason 
-type 

-  location 

-  alignment 

-  bumper  # 

-  hull  and 
turret 

orientation 

-  supplies  and 
failure  status 

First  part  of  two- 
way  interaction 

ActivateResult 

Mother 

Placed  combat 
vehicle  or  CCV. 

•  identifier 
-  result 

Second  part  of 
two-way 
interaction 
ShowCCV 

Deactivate 

Vehicle 

Mother 

Combat  vehicle 
simulator  to  be 
towed 

-  identifier 

One-way 

interaction 

Truck 

Reconstitute 

see 

Supply  truck  or 

maintenance 

team 

reconstituted 

-  identifier 
-type 

-  location 

-  supplies 

-  company 

-  force 

One-way 

interaction 

DepotDisplace 

see 

BattleMaster  has 
displaced 
ammunition  or 
fuel  depots 

One-way 

Interaction 

ServiceRequest 

Mother 

Service  Request 
PDU  received 
from  combat 
vehicle  simulator 

-truck 

identifier 

-combat 

vehicle 

identifier 

One-way 

Interaction 

Table  2.5-1:  Maint  Process  Interprocess  Messages. 
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The  Maint  Process  CSC  consists  of  the  following  second  level  CSCs: 


Initialization  and  Communication 
Truck  Dispatching 
Servicing 


2.5.1  Initialization  and  Communication 

The  Maint  Process  opens  a  connection  with  the  Maint  Mac  and  then  sends  down  the  initial 
location  of  all  the  maintenance  trucks.  It  listens  to  messages  from  the  Mother  process 
(such  as  when  a  truck  is  killed)  and  passes  that  information  along  to  the  Macintosh.  It 
listens  to  messages  from  the  Mac  indcating  when  a  truck  is  being  dispatched  or  is  repairing 
a  vehicle,  reconstituted,  etc.  It  contains  one  CSU,  main.c. 


2.5. 1.1  main.c 

/simnet/mcc/Maint/main.c 


main.c  contains  the  top  level  code  of  the  Maintenance  Console  host  process.  Table  2.5-2 
describes  the  variables  used  by  main.c. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

maintState 

TruckState 

/si  mnet/mcc/Mai  nt/Mai  nthost . 
h 

Table  2.5*2:  main  Variable  Information. 


2. 5. 1.1.1  main 

main  is  the  entry  point  to  the  Maint  process.  The  function  call  is  main(argc,  argv).  Table 
2.5-3  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

aroc 

int 

Standard  C  type. 

arqv 

pointer  to  pointer  to  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

InitializeProcess 

Section  2.21.1.19.1. 

OpenHostSocket 

Section  2.21.1.7.1. 

ActivateConsole 

Section  2.21.1.7.2. 

AlarmsEnabled 

Section  2.21.2.4.4. 

Table  2.5-3:  main  Information. 

2. 5. 1.1. 2  ProcessMessage 

ProcessMessage  processes  a  message  from  another  process,  type  indicates  whether  the 
message  is  a  one-way,  asynchronous  or  sychronous  request,  or  a  response  to  a  previous 
request,  kind  indicates  the  type  of  message  which  has  been  received,  length  indicates  the 
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length  of  the  data  in  the  message  received,  data  is  a  pointer  to  the  actual  message  data. 
Information  is  extracted  from  &e  message  data  based  on  the  kind  of  message.  The  function 
call  is  ProcessMessage(type,  kind,  length,  data).  Table  2.5-4  describes  the  parameters 
used,  errors  returned  and  functions  called  using  this  function. 


Parameters 


Parameter 


e 


kind 


lenath 


data 


Variable 


alarmsEnabled 


inter  to  char 


Internal  Variables 


e 


Mai  ntT  owFailedRequest 


Where  Tvoedef  Declared 


Standard  C  tvoe. 


Standard  C  tvoe. 


Standard  C  tvoe. 


Standard  C  type. 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  type. 


/simnet/mcc/include/Maint.h 


Errors 


Error  Name  Reason  for  Error 


MCC_UNEXPECTED_MESS  Message  of  unexpected  kind. 
AGE 


Calls 

Function 

Where  Described 

AlarmsEnabled 

Section  2.21.2.4.4. 

ATPTransact 

Section  2.21.1.7.3. 

CloseSocket 

Section  2.21.2.10.4. 

ResetCiock 

Section  2.5.1. 1.3. 

TruckKilled 

Section  2.5.2,1.5. 

SendDepotRequest 

Section  2.5. 1.1. 6. 

ServiceRequest 

Section  2.5.3. 1.1. 

ReconstituteTruck 

Section  2. 5. 2. 1.2. 

Table  2.5-4:  ProcessMessage  Information. 

2. 5. 1.1. 3  ResetCiock 

ResetClock  updates  the  clock  on  the  Macintosh.  The  function  call  is  ResetCiock  ().  Table 
2.5-5  describes  the  internal  variables  used  and  functions  called  using  this  function. 
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1  Called  Bv  1 

Function 

Where  Described 

ProcessMessaqe 

Section  2.5. 1.1. 2. 

Table  2.5-5:  ResetClock  Information. 

2. 5. 1.1. 4  RequestArrived 

RequestAnived  processes  an  ATP  Request,  t,  from  the  Maint  Macintosh.  The  function  call 
is  RequestArriv^(t).  Table  2.5-6  describes  the  parameters  used,  errors  returned  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

1 

pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

Errors 

Error  Name 

Reason  for  Error 

MCC  GETREQUEST  FAILE 

D 

ATPGetRequest  failed. 

MCC  UNKNOWN  REQUEST 

Unknown  request  from  Macintosh. 

Calls 

Function 

Where  Described 

ATPGetRequest 

Section  2.21.1.1.5. 

ProcessGridI  nfo  Request 

Section  2.21.1.16.1. 

SendForceRequest 

Section  2.5.1. 1.5. 

InitializeAllT rucks 

Section  2.5. 1.1. 7. 

TruckDispatched 

Section  2.5.2.I.4. 

Truck  Arrived 

Section  2.5.2.I.3. 

PerlormRepair 

Section  2.5. 3. 1.2. 

Table  2.5-6:  RequestArrived  Information. 


2.5. 1.1.5  SendForceRequest 

SendForceRequest  downloads  battalion  and  company  ForcelDs  to  the  Macintosh.  The 
function  call  is  SendForceRequest().  Table  2.5-7  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

req 

MaintForceRequest 

/simnet/mcc/include/Maint.h 

i 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

ATPPut 

Section  2.21.1.7.4. 

[  1 
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1  Called  Bv  1 

Function 

Where  Described 

RequestArrived 

Section  2.5. 1.1 .4. 

Table  2.5-7:  SendForceRequest  Information. 

2. 5. 1.1. 6  SendDepotRequest 

SendDepotRequest  downloads  a  depot  location  to  the  Macintosh.  The  function  call  is 
SendDepotRequest().  Table  2.5-8  describes  the  internal  variables  used  and  functions  called 
using  this  function. 


I  Internal  Variables  I 

Variable 

Where  Tvpedef  Declared 

req 

MaintDepotRequest 

/simnet/mcc/include/Maint.h 

I  Calls  I 

Function 

Where  Described 

ATPPut 

Section  2.21.1.7.4. 

I  Called  By  I 

Function 

Where  Described 

InitializeAllTaicks 

Section  2. 5. 1.1.7. 

ProcessMessaqe 

Section  2.5. 1.1. 2. 

Table  2.5-8:  SendDepotRequest  Information. 

2. 5. 1.1. 7  InitializeAllTrucks 

InitializeAllTrucks  ships  the  initial  truck  parameters  to  the  Macintosh.  The  function  call  is 
InitializeAllTrucks().  Table  2.5-9  describes  the  internal  variables  used  and  functions  called 
using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

state 

register  pointer  to  TruckState 

/simnet/mcc/Maint/Mainthost. 

h 

i 

register  short 

Standard  C  type. 

Calls 

Function 

Where  Described 

TurnFleetIntoCapabilities 

Section  2.5. 2. 1.7. 

InitializeTruck 

Section  2.5.2.I.I. 

SendDepotRequest 

Section  2. 5. 1.1. 6. 

Called  Bv 

Function 

Where  Described 

RequestArrived 

Section  2. 5. 1.1. 3. 

Table  2.5-9:  InitializeAllTrucks  Information. 
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2. 5. 1.1. 8  LookupTruckNumber 


LookupTruckNumber  finds  a  truck  state  record  for  a  truck  specified  by  truckNumber  and 
ccyjobilities.  The  function  call  is  LookupTruckNumberftruckNumber,  capabilities).  Table 
2.5-10  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

truckNumber 

int 

Standard  C  type. 

capabilities 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

&maintState[truckNumber] 

int 

The  truck  maintenance  state 
record 

i  Called  By  1 

Function 

Where  Described 

ReconstituteTruck 

Section  2.5.2. 1.2. 

T  ruckArrived 

Section  2.5.2. 1.3. 

TruckDispatched 

Section  2.5.2. 1.4. 

PerformRepair 

Section  2.5.3.I.2. 

Table  2.5*10:  LookupTruckNumber  Information. 


2. 5. 1.1. 9  LookupCCVNumber 

LookupCCVNumber  finds  a  CCV  state  record,  specified  by  ccvNumber.  Given  the  CCV 
number  of  the  vehicle,  return  the  data  which  corresponds  to  it.  CCV  numbers  are  unique 
among  all  MCC  vehicles.  The  function  call  is  LookupCCVNumberfccvNumber).  Table 
2.5-1 1  describes  the  parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

ccvNumber 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

&maintState[ccvNumber  -  first 
BnRepairVehiclel 

int 

The  CCV  maintenance  state 
record 

Called  By 

Function 

Where  Described 

TruckKilled 

Section  2.5.2. 1.5. 

ServiceRequest 

Section  2.5.3. 1.1. 

Table  2.5-11:  LookupCCVNumber  Information. 


175 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.5.2  Truck  Dispatching 

When  Maint  receives  a  message  from  the  Mac  indicating  a  truck  is  to  be  moved,  Maint 
sends  a  message  to  Mother  to  deactivate  the  truck.  The  Maint  Mac  sends  another  message 
when  it  is  time  for  a  truck  to  arrive  at  its  destination.  The  Maint  Process  sends  a  message  to 
Mother  to  place  the  maintenance  vehicle  again  at  its  new  location.  The  only  CSU  is 
displace.c. 


2.5.2. 1  displace.c 

/simnet/mcc/Maint/displace.c 

displace.c  contains  routines  for  placing  and  displacing  trucks  controlled  firon  the 
Maintenance  Console. 

2. 5. 2. 1.1  InitializeTruck 

InitializeTruck  downloads  the  initial  parameters  for  a  single  truck  to  the  Macintosh,  state 
points  to  a  local  structure  which  contains  more  information  on  the  truck;  pars  is  the  data 
structure  in  shared  memory  which  holds  some  information  on  the  truck.  The  function  call 
is  InitializeTruck(state,  pars).  Table  2.5-12  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

state 

register  pointer  to  TruckState 

/simnet/mcc/Maint/Mainthost. 

h 

pars 

register  pointer  to 
TruckParameters 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

req 

MaintTeamRequest 

/simnet/mcc/include/Maint.h 

guises 

VehicleGuises 

/simnet/common/include/prot 

ocol/basic.h 

1  Calls  1 

Function 

Where  Described 

RestoreTruck 

Section  2.5.2.1.6. 

GetGuises 

Section  2.21.1.17.1. 

DisplayCCV 

Section  2.21.1.6.1. 

ATPTransact 

Section  2.21.1.7.3. 

1  Called  Bv  1 

Function 

Where  Described 

InitializeAllTrucks 

Section  2. 5. 1.1. 7. 

ReconstituteTruck 

Section  2.5.2.I.2. 

Table  2.5*12:  InitializeTruck  Information. 
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2. 5. 2. 1.2 


ReconstituteTruck 


ReconstituteTnick  resets  a  truck  to  the  ready  state  with  a  new  position,  company  and 
alignment,  msg  contains  the  truck's  vehicle  number,  its  capabilities,  a  location,  and  the 
organization.  The  function  call  is  ReconstituteTruck(msg).  Table  2.5*13  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

msg 

pointer  to  MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

Internal  Variables 

Variable 

Tvoe 

Where  Tvpedef  Declared 

state 

register  pointer  to  TruckState 

/simnet/mcc/Maint/Mainthost. 

h 

pars 

register  pointer  to 
TruckParameters 

/simnet/mcc/include/MCC_par 

s.h 

Calls 

Function 

Where  Described 

Lookup!  ruckNumber 

Section  2. 5. 1.1. 8. 

GetlruckParameters 

Section  2.21.1.29.1. 

Lock 

Section  2.21.2.6.3. 

Unlock 

Section  2.21.2.6.4. 

InitializeTruck 

Section  2.5.2.I.I. 

Called  By 

Function 

Where  Described 

ProcessMessaqe 

Section  2. 5. 1.1. 2. 

Table  2.5-13:  Reconstitute!  ruck  Information. 

2. 5. 2. 1.3  TruckArrived 

TruckArrived  is  called  when  a  truck  arrives  at  its  destination,  t  contains  an 
MaintArriveRequest  which  holds  information  about  the  truck,  such  as  its  fleet  and  its 
vehicle  number.  The  function  call  is  TruckArrived(t).  Table  2.5-14  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

1  1 
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Internal  Variables 

Variable 

Where  Typedef  Declared 

state 

pointer  to  TruckState 

/simnet/mcc/Maint/Mainthost. 

h 

pars 

pointer  to  TruckParameters 

/simnet/mcc/include/MCC jsar 
s.h 

guises 


capabilities 


inter  to  MaintArriveReauest 


pointer  to 

MaintArriveResoonse 


VehicleGuises 


VehicleCapabilities 


/simnet/mcc/include/Maint.h 


/simnet/mcc/include/Maint.h 


/simnet/common/inciude/prot 

ocol/basic.h 


/simnet/common/include/prot 

ocol/basic.h 


Function 


ATPReauestData 


TurnFleetlntoCaoabilities 


LookupTruckNumber 


GetT  ruckParameters 


RestoreTruck 


GetGuises 


DisolavCCV 


SendConsoleResponse 


Calls 


Where  Described 


Macro  defined  in  /simnet/mcc/include/bridae.h. 


Section  2.5.2. 1.7. 


Section  2. 5. 1.1. 8. 


Section  2.21.1.29.1. 


Section  2.5.2. 1.6. 


Section  2.21.1.17.1. 


Section  2.21.1.6.1. 


Section  2.21.1.7.6. 


Called  B 


Function 

Where  Described 

RequestArrived 

Section  2. 5. 1.1. 4. 

Table  2.5*14:  TruckArrived  Information. 

2. 5. 2. 1.4  TruckDispatched 

TruckDispatched  is  called  when  a  truck  has  been  dispatched,  t  contains  the  fleet  and 
vehicle  number  of  the  truck  to  dispatch.  The  function  call  is  TruckDispatched(t).  Table 
2.5-15  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


Variable 


req 


to  win 


msg 

Cc;  .^abilities 


veh 


Parameters 


inter  to  Transaction 


Where  Tvoedef  Declared 


/simnet/mcc/include/bridae.h 


Internal  Variables 


e 


pointer  to 

MaintDisoatchReauest 


register  pointer  to  TruckState 


unsigned  char 


MCCMessageBuffer 


VehIcleCaDabilities 


pointer  to  VehiclelDStatus 


Where  Typedef  Declared 


/si  mnet/mcc/include/Maint .  h 


/simnet/mcc/Maint/Mainthost. 

h 


Standard  C  tvoe. 


/simnet/mcc/include/MCCJpc 

.h 


basic. h 


/simnet/mcc/include/veh  tabi 
e.h 
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Calls 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

TurnFleetlntoCapabi  lilies 

Section  2  5.2.1.7. 

LookuoT  ruckNumber 

Section  2.5. 1.1. 8. 

SendConsoleResponse 

Section  2.21.1.7.6. 

FQueue  Retrieve 

Section  2.21.1.13.7. 

RestoreTruck 

Section  2.5.2. 1.6. 

SendMCCMsql 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

HideCCV 

Section  2.21.1.6.2. 

Called  By 

Function 

Where  Described 

RequestArrived 

Section  2. 5. 1.1 .4. 

Table  2.5*15:  TruckDispatched  Information. 

2. 5. 2. 1.5  TruckKilled 

TruckKilled  is  called  when  a  truck  has  been  destroyed,  msg  is  the  CCV  number  of  the 
destroyed  truck.  The  function  call  is  TruckKilled(msg).  Table  2.5-16  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedet  Declared 

msg 

pointer  to  MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

state 

register  pointer  to  TruckSlale 

/simnet/mcc/Maint/Mainthost. 

h 

req 

MaintKilledRequest 

/simnet/mcc/include/Maint.h 

Calls 

Function 

Where  Described 

LookupCCVNumber 

Section  2. 5. 1.1. 9. 

RestoreTruck 

Section  2. 5. 2.1. 6. 

ATPPut 

Section  2.21.1.7.4. 

Called  By 

Function 

Where  Described 

ProcessMessaqe 

Section  2. 5. 1.1. 2. 

Table  2.5*16:  TruckKilled  Information. 
2. 5. 2. 1.6  RestoreTruck 


RestoreTruck  is  called  when  a  truck  is  now  stationary,  visible  and  healthy.  The  function 
call  is  RestoreTruck(state).  Table  2.5-17  describes  the  parameters  used,  errors  returned 
and  functions  called  using  this  function. 
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Parameters 

Parameter 

Where  Tvpedef  Declared 

state 

register  pointer  to  TruckState 

/simnet/mcc/Maint/Mainthost. 

h 

Variable 


pars 


rsoKind 


rsoLen 


errCode 


msg 


capabilities 


Internal  Variables 


pointer  to  TruckParameters 


MCCMessageBuffer 


VehicleCapabilities 


Where  Tvoedef  Declared 


/simnetymcc/include/MCC_par 

s.h 


Standard  C  t 


Standard  C  type. 


Standard  C  type. 


/si  mnet/nxx:/i  nclude/MCCJpc 
•h 


/simnet/common/mclude/prot 

ocol/basic.h 


Error  Name 


MCC_UNEXPECTED_MESS 

AGE 


Errors 


Reason  for  Error 


Message  of  unexpected  kind. 


Function 


CancelAlarm 


TurnFleetlntoCapabilities 


GetTruckParameters 


Transact 


TraceMessaae 


Calls 


Where  Described 


Section  2.21.2.4.3. 


Section  2.5  2.1.7. 


Section  2.21.1.29.1. 


Section  2.21.2.10.9. 


Section  2.21.1.19.3. 


Function 


InitializeTnjck 


TruckArrived 


TruckDi  snatched 


TruckKilled 


Called  B 


Where  Described 


Section  2.5.2. 1.1. 


Section  2.5.2.I.3. 


Section  2.5. 2. 1.4. 


Section  2.5  2.1.5. 


Table  2.5-17:  RestoreTruck  Information. 


2 .5.2. 1 .7  TurnFleetlntoCapabilities 

TurnFleetlntoCapabilities  takes  a  fleet  and  initializes  the  appropriate  fields  of  a  capabilities 
structure  from  a  fleet  type,  where  fleet  is  either  ammunition,  fuel,  pallet,  or  maintenance; 
cap  is  a  vehicle  capabilities  structure  that  marks  TRUE  with  all  the  capabilities  of  the  truck. 
The  function  call  is  TumFleetlntoCapabilities(fleet,  cap).  Table  2.5-18  describes  the 
parameters  used  by  using  this  function. 


Parameter 


fleet 


cap 


Parameters 


pointer  to  VehicleCapabilities 


Where  Typedef  Declared 


Standard  C  type. 


/simnet/common/include/prot 

ocol/basic.h 
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1  Called  By  1 

Function 

Where  Described 

InitializeAllTrucks 

Section  2.5.1 .1.7. 

TruckArrived 

Section  2.5.2.I.3. 

TruckDispatched 

Section  2.5. 2. 1.4. 

RestoreTruck 

Section  2.5.2.I.6. 

PertormRepair 

Section  2.5.3.I.2. 

Table  2.5-18:  TurnFleetIntoCapabilities  Information. 


2.5.3  Servicing 

Maint  receives  messages  from  Mother  when  a  combat  vehicle  is  close  enough  to  a  truck  and 
needs  to  be  repaired  or  recovered.  The  operator  at  the  Maint  Macintosh  selects  a  repair  or 
designates  the  vehicle  to  be  recovered.  If  a  repair  is  to  occur,  the  internal  state  of  the  truck 
is  set  to  servicing  and  it  sends  out  packets  which  offer  servicing.  At  the  end  of  the  time  it 
takes  to  perform  the  selected  repair,  the  Maint  process  sends  out  a  packet  stating  that  the 
repair  has  been  completed.  If  the  vehicle  moves  away  from  the  maintenance  team  during 
the  repair,  the  repair  is  cancelled.  If  the  vehicle  is  to  be  recovered,  Maint  sends  a  message 
to  Mother  to  deactivate  the  CCV  and  the  combat  vehicle.  When  it  is  time  for  the  team  to 
arrive  at  its  destination,  Maint  sends  Mother  another  message  to  place  the  CCV  and 
reconstitute  the  combat  vehicle  at  the  new  location.  This  functionality  is  realized  by  the 
CSU  service.c. 


2. 5. 3.1  service.c 

/simnet/mcc/Maint/service.c 

service.c  contains  routines  which  implement  the  servicing  of  vehicles  by  the  maintenance 
teams.  Table  2.5-19  shows  variables  used  by  service.c. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

nextRepairEventlD 

unsiqned  short 

Standard  C  type. 

Table  2.5-19:  service.c  Variable  Information. 

2.5.3. 1.1  ServiceRequest 

ServiceRequest  is  called  when  a  combat  vehicle  wants  service  from  a  truck,  as  indicated  by 
msg.  The  function  call  is  ServiceRequest(msg).  Table  2.5-20  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

msg 

pointer  to  MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

1  1 
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1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

state 

register  pointer  to  TruckState 

/simnet/mcc/Maint/Mainthost. 

h 

vehiclelD 

VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

red 

MaintServicinoReauest 

/simnet/mcc/include/Maint.h 

veh 

pointer  to  VehicielOStatus 

/simnet/mcc/include/veh_tabl 

e.h 

1  Calls  1 

Function 

Where  Described 

LookupCCVNumber 

Section  2.5.1. 1.9. 

FQueue  Retrieve 

Section  2.21.1.13.7. 

Section  2.21.1.25.6. 

ATPPut 

Section  2.21.1.7.4. 

CancelAlarm 

Section  2.21.2.4.3. 

SetAlarm 

Section  2.21.2.4.2. 

1  Called  Bv  1 

Function 

Where  Described 

ProcessMessaae 

Section  2.5. 1.1 .2. 

Table  2.5*20:  ServiceRequest  Information. 


2.5.3. 1.2  PerformRepair 

PerforaiRepair  is  called  when  a  repair  has  been  completed.  The  function  call  is 
PerformRepair(t).  Table  2.5-21  describes  the  parameters  used  and  functions  called  using 
this  function. 


Parameter 


Variable 


req 


caDabilities 


msg 


Parameters 


inter  to  Transaction 


Where  Tvpedef  Declared 


/simnet/mcc/include/bridae.h 


Internal  Variables 


e 


pointer  to 

MaintReoairReouest 


register  pointer  to  TruckState 


VehicleCapabilities 


M  CC  M  essageBuff  er 


Where  Tvpedef  Declared 


/si  mnet/mcc/i  nclude/Mai  nt .  h 


/simnet/mcc/Maint/Mainthost. 

h 


basic.h 


/simnet/mcc/include/MCCjpc 

.h 


Function 


ATPReauestData 


TurnFleetIntoCaoabilities 


LookupT  ruckNumber 


SendConsoleResponse 


SeeMCCMsol 


Calls 


Where  Described 


Macro  defined  in  /simnet/mcc/include/bridqe.h. 


Section  2. 5.2. 1.7, 


Section  2.5. 1.1. 8. 


Section  2.21.1.7.6. 


Macro  defined  in  /simnet/mcc/include/MCC  i 
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1  Called  By  1 

Function 

Where  Described 

RequestArrived 

Section  2.5. 1.1 .4. 

Table  2.5-21:  PerformRepair  Information. 


2.5.3. 1.3  ReadyTimeout 

ReadyTimeout  returns  a  truck  to  the  ready  state  when  no  additional  Service  Request  PDUs 
seem  to  be  forthcoming,  param  contains  the  TruckState  of  the  truck  offering  the  supplies;  a 
is  the  alarm  which  initiat^  this  call.  The  function  call  is  ReadyTimeout(param,  a).  Table 
2.5-22  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


DT! 


Alarm 


Variable 


state 


Internal  Variables 


pointer  to  TruckState 


MaintServicinqRequest 


Where  Tvpedef  Declared 


Standard  C  t 


/simnet/rcs/libiDc/alarm.h 


Where  Tvoedef  Declared 


/simnet/mcc/Maint/Mainthost. 

h 


/si  mnet/mcc/i  ncluce/M  ai  nt .  h 


Function 


ATPPut 


Calls 


Where  Described 


Section  2.21.1.7.4. 


Table  2.5-22:  ReadyTimeout  Information. 
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2.6  The  FSE  (Fire  Support  Element)  Process 

The  FSE  Process  supports  indirect  fire  missions  carried  out  by  mortars  and  howitzers.  It 
controls  the  delivery  of  fire  and  controls  when  the  mortars  and  howitzers  are  visible  or 
invisible.  Its  structure  is  shown  in  Figure  2.6-1. 


Figure  2.6-1:  FSE  (Fire  Support  Element)  Process  Structure. 
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The  FSE  process  sends  and  receives  the  interprocess  messages  listed  in  Table  2.6-1. 


Received 

From 


Mother 


Sent  To  I  In  Response  To  I  Data  Sent  Transaction  Type 


ArtyArrive 


Arty  see 

Reconstitute 


eev  needs  to  be 
visible 


eev  needs  to  be 
invisible 


When  eev  killed 
as  shown  by 
these  PDUs: 
Vehicleimpact 
eollision 
Indirect  Fire 


Placed  combat 
vehicle  or  eev. 


-ownership 

-identifier 

-type 

-alignment 

-role 

-company 

-location 

-direction 


-  indentifier 


-  identifier 


-  identifier 

-  result 


Artillery  shells  -  type  of 

detonate  on  or  ammo 

above  battlefield  -  type  of  fuze 

-  flight  time 

-  number  of 
shells 

For  each 

shell’s 

detonation; 

-  horizontal 
location 

-  height 

-  delay  before 
next 


BattleMaster  -  identifier 
wants  to  dispatch  -  platoon 
platoon  of 
howitzers 


Howitzers  have 
arrived 


-  identifier 

-  platoon 

-  location 

-  azimuth 


BattleMaster 
wants  to 
reconstitute 
platoon  of 
howitzer  batte 


First  part  of  two- 
way  interaction 


One-way 

interaction 


One-way 

interaction 


Second  part  of 
two-way 
interaction 
ShowCev 


One-way 

interaction 


One-way 

interaction 


One-way 

interaction 


One-way 

interaction 


Table  2.6-1:  FSE  Process  Interprocess  Messages. 
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The  FSE  Process  is  composed  of  the  following  second  level  CSCs: 

Initialization  and  Communication 
Positioning  of  Howitzers  and  Mortars 
Delivery  of  Fire 


2.6.1  Initialization  and  Communication 

The  FSE  Process  opens  a  connection  with  the  FSE  Mac  and  sends  down  the  initial  location 
of  the  batteries  of  howitzers  and  platoon  of  mortars.  It  listens  to  messages  from  the  Mother 
process  such  as  those  which  describe  when  a  gun  is  destroyed.  It  listens  to  messages 
from  the  FSE  Console  determining  when  a  mortar  is  displaced,  or  when  a  fire  mission  is  to 
be  started.  It  consists  of  the  following  CSUs: 

main.c 

data.c 


2.6. 1.1  main.c 

/simnet/mcc/FSE/main.c 

main.c  contains  the  top-level  code  for  the  FSE  host  process. 

2. 6. 1.1.1  main 

main  is  the  entry  point  to  the  FSE  process.  The  function  call  is  main(argc,  argv).  Table 
2.6-2  describes  the  parameters  usedd  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

argc 

int 

Standard  C  type. 

arav 

pointer  to  pointer  to  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

InitializeProcess 

Section  2.21.1.19.1. 

OpenHoslSockef 

Section  2.21.1.7.1. 

ActivateConsole 

Section  2.21.1.7.2. 

AlarmsEnabled 

Section  2.21.2.4.4. 

Table  2.6-2:  main  Information. 

2. 6. 1.1. 2  ProcessMessage 

ProcessMessage  processes  a  message  from  another  process,  type  indicates  whether  the 
message  is  a  one-way,  asynchronous  or  sychronous  request,  or  a  response  to  a  previous 
request,  kind  indicates  the  type  of  message  which  has  been  received,  length  indicates  the 
length  of  the  data  in  the  message  received,  data  is  a  pointer  to  the  actual  message  data. 
Information  is  extracted  from  the  message  data  based  on  the  kind  of  message.  The  function 
call  is  ProcessMessage(type,  kind,  length,  data).  Table  2.6-3  describes  the  parameters 
used,  errors  returned  and  functions  called  u.sing  this  function. 
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Parameters 


Parameter 


lenoth 


data 


Variable 


alarmsEnabled 


reoister  pointer  to  char 


Internal  Variables 


e 


Where  Tyoedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C 


Where  Tyoedef  Declared 


Standard  C  t 


Error  Name 


MCC_UNEXPECTED_MESS 

AGE 


Errors 


Reason  for  Error 


Message  of  unexpected  kind. 


Function 


AlarmsEnabled 


ATPTransact 


CloseSocket 


ResetClock 


TubeKilled 


ReconstituteBatte 


RemoteDispatch 


RemoteArrive 


Where 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Section 


Calls 


Described 


2.21.2.4.4. 


2.21.1.7.3. 


2.21.2.10.4. 


2.6.1. 1.7. 


2.6.1. 1.6. 


2.6.I.I.5. 


2.6.2.I.5. 


2.62.1.6. 


Table  2.6*3:  ProcessMessage  Information. 


2. 6. 1.1. 3  Request  Arrived 

RequestArrived  processes  a  transaction  request,  t,  from  the  FSE  Console.  The  function 
call  is  RequestArrived(t).  Table  2.6-4  describes  the  parameters  used,  errors  returned  and 
functions  called  using  this  function. 


BBN  Systems  and  Technologies  MCC  CSCl 


1  Calls  1 

Function 

Where  Described 

ATPGetRequest 

Section  2.21.1.1.5. 

ProcessGrid  1  nfo  Request 

Section  2.21.1.16.1. 

InitializeBattery 

Section  2.6.1. 1.4. 

ATPTransact 

Section  2.21.1.7.3. 

Fire  Request 

Section  2.6.3.I.I. 

FPFRequest 

Section  2.6  3.1.4. 

LocalDispatchRequest 

Section  2.6.2.I.3. 

LocalArriveRequest 

Section  2  6.2.1.4. 

Table  2.6-4:  RequestArrived  Information. 


2. 6. 1.1. 4  InitializeBattery 

InidalizeBattery  initializes  a  battery  of  guns.  The  function  call  is  InitializeBatteiy(battery, 
location,  azimuth,  ammo).  Table  2.6-5  describes  the  parameters  used  and  functions  called 
using  this  function. 


Parameter 


batte 


location 


azimuth 


ammo 


Parameters 


e 


int 


pointer  to  LongPt 


int 


array  of  short 


Where  Tvoedef  Declared 


Standard  C  tvoe. 


/simnet/common/include/glob 

al/lonqpt.h 


Standard  C  t 


Standard  C  type. 


Variable 


iBTn 


Internal  Variables 


e 


reoister  pointer  to  Batte 


reoister  pointer  to  Tube 


short 


short 


short 


FSEGunInitRequest 


Where  Tvoedef  Declared 


/simnet/mcc/FSE/FSEhost.h 


/simnet/mcc/FSE/FSEhost.h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


/simnet/mcc/include/FSE.h 


Calls 

Function 

Where  Described 

PlaceHalf 

Section  2.6.2.I.2. 

ATPTransact 

Section  2.21.1.7.3. 

Function 


ReconstituteBatte 


RequestArrived 


Called  B 


Where  Described 


Section  2.6.1. 1.5. 


Section  2.6.1. 1.3. 


Table  2.6-5:  InitializeBattery  Information. 
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2.6. 1.1.5  ReconstituteBattery 

ReconstituteBattery  is  called  to  reset  a  battery  to  the  ready  state,  msg  contains  detailed 
information  about  the  battery.  The  function  call  is  ReconstituteBattery(msg).  Table  2,6-6 
describes  the  parameters  us^,  errors  returned  and  functions  called  using  this  function. 


Parameters 


Parameter 


msg 


Variable 


batte 


ID73 


register  pointer  to 
MCCMessaaeBuffer 


lETT 


Internal  Variables 


e 


Where  Tvoedef  Declared 


/simnet/mc/include/MCC_ipc. 

h 


Where  Tvpedef  Declared 


Standard  C  t 


Standard  C  t 


Function 


Calls 


Where  Described 


Section  2. 6.1. 1.4. 


Called  B 


Function 

Where  Described 

ProcessMessaqe 

Section  2.6. 1.1. 2. 

Table  2.6*6:  ReconstituteBattery  Information. 

2. 6. 1.1. 6  TubeKilled 

TubeKilled  is  called  when  a  gun  has  been  destroyed.  The  function  call  is 
TubeKilled(msg).  Table  2.6-7  describes  the  parameters  used  and  functions  called  using 
this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

msg 

pointer  to  MCCMessageBuffer 

/simnet/rrxj/include/MCC  ipc. 
h 

Variable 


iEni! 


Internal  Variables 


e 


FSEKilledReouest 


short 


short 


short 


Where  Tvoedef  Declared 


/simnet/mcc/include/FSE.h 


Standard  C  t 


Standard  C  t 


Standard  C  t 
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1  Called  By  1 

Function 

Where  Described 

ProcessMessaqe 

Section  2. 6. 1.1. 2. 

Table  2.6-7:  TubeKilled  Information. 

2. 6. 1.1. 7  ResetClock 

ResetClock  tells  the  Macintosh  the  time.  The  function  call  is  ResetQock().  Table  2.6-8 
describes  the  internal  variables  used  by  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

req 

FSECIockRequest 

/si  mnet/mcc/i  nclude/FS  E .  h 

1  Calls  1 

Function 

Where  Described 

MacintoshTime 

Section  2.21.1.27.1. 

ATPPut 

Section  2.21.1.7.4. 

1  Called  By  1 

Function 

Where  Described 

ProcessMessaqe 

Section  2. 6. 1.1. 2. 

Table  2.6-8:  ResetClock  Information. 


2.6. 1.2  data.c 

/simnet/mcc/FSC/data.c 

data.c  contains  data  declarations  for  the  FSE  host  process.  Table  2.6-9  shows  the  varibles 
declared  in  data.c. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

batteries 

array  of  Battery 

/simnet/mcc/FSE/FSEhost.h 

Table  2.6-9:  data.c  Variable  Information. 


2.6.2  Positioning  of  Howitzers  and  Mortars 

The  mortar  platoon  can  be  displaced  from  the  FSE  Macintosh  while  the  howitzer  batteries 
may  only  be  moved  by  the  Battlemaster  via  the  SCC  process.  This  file  contains  routines 
that  control  the  howitzers  and  mortars  visibility.  The  mortar  platoon  and  howitzer  batteries 
can  be  placed  one  half  at  a  time.  There  is  one  CSU  in  this  second  level  CSC,  position.c. 
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2.6.2. 1  position. c 

/simnet/mcc/FSE/position.c 


position.c  contains  routines  which  implement  the  positioning  of  batteries,  including 
displacement 


2. 6. 2. 1.1  IsMortar 


IsMortar  is  a  utility  routine  which  determines  whether  vehType  is  a  mortar.  The  function 
call  is  IsMortar(vehType).  Table  2.6-10  describes  the  parameters  used  by  using  this 
function. 


1  Parameters  I 

Parameter 

Where  Typedef  Deciared 

vehType 

ObjectType 

/simnet/common/inciude/prot 

ocol/basic.h 

Return  Values 

Return  Value 

Meaning 

TRUE 

int 

Vehicle  is  mortar. 

FALSE 

int 

Vehicle  is  not  mortar. 

1  Called  By  1 

Function 

Where  Described 

PlaceHalf 

Section  2.6.2. 1.2. 

Table  2.6-10:  IsMortar  Information. 


2. 6. 2. 1.2  PlaceHalf 

PlaceHalf  positions  one  half  of  a  battery.  The  function  call  is  PIaceHalf(b,  half,  location, 
azimuth).  Table  2.6-1 1  describes  the  parameters  used  and  functions  called  using  this 
function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

b 

pointer  to  Battery 

/simnet/mcc/FSE/FSEhost.h 

half 

int 

Standard  C  type. 

location 

pointer  to  LongR 

/simnet/common/include/glob 

al/lonqpt.h 

azimuth 

int 

Standard  C  type. 

I  I 
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Variable 


alionment 


marking 


guises 


capabilities 


Internal  Variables 


e 


reaister  pointer  to  Half 


inter  to  Tube 


float 


short 


LongPt 


unsigned  char 


VehicleMarking 


VehicleGuises 


OrganizationalUnit 


VehicleCapabilities 


Where  Typedef  Declared 


/simnet/mcc/FSE/FSEhost.h 


/simnet/mcc/FSE/FSEhost.h 


Standard  C  t 


Standard  C  t 


/simnet/common/include/glob 

al/lonapt.h 


Standard  C  t 


/simnet/common/include/prot 

ocol/basic.h 


/simnet/common/include/prot 

ocol/basic.h 


/simnet/common/include/prot 

ocol/basic.h 


/si  mnet/commo  n/i  nclude/prot 
ocol/basic.h 


Function 


mil_to_rad 


IsMortar 


GetGuises 


InitUnit 


DisplavCCV 


Calls 


Where  Described 


Macro  defined  in 

/simnet/common/include/alobal/sim  macros. h. 


Section  2.6.2.I.I. 


Section  2.21.1.17.1. 


Section  2.21.1.19.4. 


Section  2.21.1.6.1. 


Function 


LocalArriveReouest 


RemoteArrive 


InitializeBatte 


Called  B 


Where  Described 


Section  2. 6. 2. 1.4. 


Section  2.6.2. 1.6. 


Section  2. 6. 1.2.4. 


Table  2.6-11;  PlaceHalf  Information. 

2.6.2. 1.3  LocalDispatchRequest 

LocalDispatchRequest  processes  request,  t,  from  the  FSE  Macintosh  to  dispatch  guns.  The 
function  call  is  LocalDispatchRequest(t).  Table  2.6-12  describes  the  parameters  used  and 
functions  called  using  this  function. 
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\  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SendConsoleResoonse 

Section  2.21.1.7.6. 

HideCCV 

Section  2.21.1.6.2. 

Called  Bv 

Function 

Where  Described 

RequestArrived 

Section  2.6.1. 1.3. 

Table  2.6-12:  LocalDispatchRequest  Information. 


2. 6. 2. 1.4  LocalArriveRequest 

LocalArriveRequest  processes  a  request,  t,  from  the  FSE  Macintosh  to  place  a  fire  unit  on 
the  terrain.  The  function  call  is  LocalArriveRequest(t).  Table  2.6-13  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


Where  Tvoedef  Declared 


/si  mnet/mcc/i  nclude/bridae .  h 


Variable 


arrive 


Internal  Variables 


e 


FSEArriveRequest 


IE173 


Where  Typedef  Declared 


/simnet/mcc/include/FSE.h 


Function 


ATPRequestData 


SendConsoleResoonse 


PlaceHalf 


Caffs 


Where  Described 


Macro  defined  in  /simnet/mcc/include/bridqe.h. 


Section  2.21.1.7.6. 


Section  2. 6. 2. 1.2. 


Called  B 


Function 

Where  Described 

RequestArrived 

Section  2. 6. 1.1. 3. 

Table  2.6-13:  LocalArriveRequest  Information. 
2.6.2. 1.5  RemoteDispatch 


RemoteDispatch  processes  a  notice  from  the  SCC,  msg,  that  some  howitzers  have  begun 
to  displace.  The  function  call  is  RemoteDispatch(msg).  Table  2.6-14  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

msg 

register  pointer  to 
MCCMessaqeBuffer 

/simnet/mcc/include/MCC  ipc 
h 

BBN  Systems  and  Technologies 


MCC  CSCI 


Table  2.6-14:  RemoteDispatch  Information. 

2.6.2. 1.6  RemoteArrive 

RemoteArrive  processes  a  notice  from  the  SCC,  msg,  that  some  howitzers  have  arrived  at 
their  destination.  The  function  call  is  RemoteArrive(msg).  Table  2.6-15  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


msg 


variable 


I  EH:! 


register  pointer  to 
MCCMessaqeBuffer 


Internal  Variables 


e 


FSEArriveReauest 


Where  Tvoedef  Declared 


/simnet/mcc/include/MCCJpc 

.h 


Where  Tvoedef  Declared 


/si  mnet/mcc/include/FS  E.  h 


Calls 

Function 

Where  Described 

PlaceHalf 

Section  2.6.2.I.2. 

ATPTransact 

Section  2.21.1.7.3. 

Function 


ProcessMessaae 


Called  B 


Where  Described 


Section  2.6. 1.1. 2. 


Table  2.6-15:  RemoteArrive  Information. 


2.6.3  Delivery  of  Fire 

There  are  three  different  types  of  firing:  Adjust  Fire,  Fire  For  Effect,  and  Final  Protective 
Fire.  All  three  types  are  handled  by  routines  in  fire.c.  It  provides  routines  that  randomly 
distribute  the  bursts  in  the  area  designated  and  decrements  the  count  of  ammo  from  each  of 
the  simulated  gun  tubes.  It  sends  Mother  the  schedule  of  fire  so  that  Mother  can  then  send 
out  the  appropriate  packets  on  the  network.  There  is  one  CSU,  fire.c. 
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2.6.3. 1  fire.c 

/simnet/mcc/FSE/fire.c 

fire.c  contains  routines  which  implement  the  Adjust  Fire,  Fire  For  Effect  and  FPF 
operations. 

2. 6. 3. 1.1  FireRequest 

FireRequest  processes  a  fire  request,  t,  from  the  Macintosh.  The  function  call  is 
FireRequest(t).  Table  2.6-16  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

t 

pointer  to  Transaction 

/si  mnet/mcc/i  nclude/bridqe .  h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

fire 

FSEFireRequest 

/simnet/mcc/include/FSE.h 

1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

AdjustFire 

Section  2.6.3.I.2. 

FireForEffect 

Section  2.6.3.I.3. 

1  Called  By  I 

Function 

Where  Described 

RequestArrived 

Section  2. 6.1. 1.3. 

Table  2.6«16:  FireRequest  Information. 


2. 6. 3. 1.2  AdjustFire 


AdjustFire  fires  an  adjustment  round  from  a  battery.  The  function  call  is  AdjustFire(fire). 
Table  2.6-17  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

fire 

register  pointer  to 
FSEFireRequest 

/simnet/mcc/include/FSE.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

b 

pointer  to  Battery 

/simnet/mcc/FSE/FSEhost.h 

i 

short 

Standard  C  type. 

1 

short 

Standard  C  type. 

msg 

MCCMesageBufier 

/simnet/mcc/include/MCC  ipc 
.h 

1  ^ 
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1  Calls  1 

Function 

Where  Described 

MapAmmoCode 

Section  2.6.3. 1.5. 

TimeOfFliaht 

Section  2.6.3. 1.6. 

SendMCCMsal 

Macro  defined  in /simnet/mcc/include/MCC  ipc.h. 

UpdateSharedMemorv 

Section  2.6.3.1.11. 

Called  By 

Function 

Where  Described 

FireReauest 

Section  2.6.3. 1.1. 

Table  2.6>17:  AdjustFire  Information. 


2. 6. 3. 1.3  FireForEffect 

FireForEffect  fires  a  volley  from  a  battery  in  a  parallel  sheaf.  The  function  call  is 
FireForEffect(fire,  half).  Table  2.6-18  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

fire 

register  pointer  to 
FSEFireReauest 

/si  mnet/mcc/i  nclude/FS  E  .h 

half 

int 

Standard  C  type. 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

b 

pointer  to  Battery 

/simnet/mcc/FSE/FSEhost.h 

msg 

MCCMesageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

1  Calls  1 

Function 

Where  Described 

MapAmmoCode 

Section  2. 6.3. 1.5. 

TimeOfFliaht 

Section  2. 6.3.1. 6. 

PlaceParallelSheaf 

Section  2. 6.3. 1.7. 

DistributeBursts 

Section  2. 6.3. 1.8. 

SendMCCMsal 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

UpdateSharedMemorv 

Section  2.6.3.1.11. 

1  Called  By  I 

Function 

Where  Described 

FireReauest 

Section  2. 6.3.1. 1. 

Table  2.6-18:  FireForEffect  Information. 


2. 6. 3. 1.4  FPFRequest 

FPFRequest  processes  an  FPF  request,  t,  from  the  Macintosh.  The  function  call  is 
FPFRequest(t).  Table  2.6-19  describes  the  parameters  used  and  functions  called  using  this 
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Parameter 


Parameters 


inter  to  Transaction 


Where  Tvoedef  Declared 


/si  mnet/mcc/i  nclude/bridqe  .h 


Variable 


det 


Internal  Variables 


register  pointer  to  struct 
detonation 


FSEFPFRequest 


inter  to  Batte 


inter  to  Half 


short 


short 


float 


float 


MCCMessageBuffer 


Where  Tyoedef  Declared 


/simnet/mcc/include/FSE.h 


/simnet/mcc/FSE/FSEhost.h 


/simnet/mcc/FSE/FSEhost.h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


/si  mnet/mcc/i  nclude/MCC  Jpc 
.h 


Calls 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridoe.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

DistributeBursts 

Section  2.6.3.I.8. 

MapAmmoCode 

Section  2.6.3.I.5. 

TimeOfFlight 

Section  2.6.3.I.6. 

SendMCCMsot 


UpdateSharedMemo 


Macro  defined  in  /simnet/mcc/include/MCC 


Section  2.6.3.1.11. 


Called  B 


Function 

Where  Described 

RequestArrived 

Section  2.6.1. 1.3. 

Table  2.6-19;  FPFRequest  Information. 

2. 6. 3. 1.5  MapAmmoCode 

MapAmmoCode  maps  the  ammo  codes  used  on  the  FSE  Macintosh  to  those  used  on  the 
network.  The  function  call  is  MapAmmoCode(ammo,  battery,  msg).  Table  2.6-20 
describes  the  parameters  used  by  this  function. 
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1  Called  Bv  1 

Function 

Where  Described 

FPFReauest 

Section  2.6.3.I.4. 

FireForEffect 

Section  2.6.3.1.3. 

AdjustFire 

Section  2.6.3.I.2. 

Table  2.6-20:  MapAmmoCode  Information. 

2.6.3. 1.6  TimeOfFlight 

TimeOfFlight  returns  the  time  of  flight,  in  seconds,  for  a  round  to  reach  a  target  location 
from  a  particular  battery.  The  function  call  is  TimeOfFlight(b,  half,  location,  fuze).  Table 
2.6-21  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

b 

pointer  to  Battery 

/simnet/mcc/FSE/FSEhost.h 

half 

int 

Standard  C  type. 

location 

pointer  to  LongR 

/simnet/common/include/glob 

al/longpt.h 

fuze 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

Pt 

pointer  to  LongPt 

/simnet/common/include/glob 

al/lonqpt.h 

tl 

float 

Standard  C  type. 

t2 

float 

Standard  C  type. 

i 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

b->timeOfFlight 

int 

Time  of  flight  for  round. 

1  Called  Bv  1 

Function 

Where  Described 

FPFRequest 

Section  2  6.3.1.4. 

FireForEffect 

Section  2. 6.3. 1.3. 

AdjustFire 

Section  2.6.3.I.2. 

Table  2.6-21:  TimeOfFlight  Information. 

2. 6. 3. 1.7  PlaceParallelSheaf 

PlaceParallelSheaf  places  bursts  in  a  parallel  sheaf.  The  function  call  is 
PlaceParallelSheaf(b,  half,  source,  dest,  msg).  Table  2.6-22  describes  the  parameters  used 
by  this  function. 
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Parameters 


Parameter 


inter  to  Batte 


half 

int 

source 

pointer  to  LongR 

dest 

pointer  to  LongR 

msg 

pointer  to  MCCMessageBuffer 

MCCCSCI 


Where  Typedef  Declared 


/simnet/mcc/FSE/FSEhost.h 


Standard  C  t 


/simnet/common/include/glob 

al/lonoDt.h 


/simnet/common/include/glob 

al/lonqpt.h 


Internal  Variables 

Variable 

Where  Typedef  Declared 

t 

1  reoister  pointer  to  Tube  1 

/simnet/mcc/FSE/FSEhost.h 

det 


displace 


register  pointer  to  stmct 
detonation 


array  2  of  float 


short 


short 


Standard  C  t 


Standard  C  type. 


Called  B 


Function 

Where  Described 

FireForEffect 

Section  2. 6.3. 1.3. 

Table  2.6-22:  PlaceParalleiSheaf  Information. 

2. 6. 3. 1.8  DistributeBursts 

DistributeBursts  randomly  distributes  bursts  in  time  and  space.  The  function  call  is 
DistributeBursts(msg,  fuze,  first).  Table  2.6-23  describes  the  parameters  used  and 
functions  called  using  this  fiinction. 
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1  Called  By  1 

Function 

Where  Described 

FPFReauest 

Section  2.6.3.I.4. 

FireForEffect 

Section  2.6.3.I.3. 

Table  2.6-23:  DistributeBursts  Information. 

2.6.3. 1.9  RandomDistance 

RandomDistance  generates  a  random  distance  abberation.  The  function  call  is 
RandomDistanceQ.  Table  2.6-24  describes  the  internal  variables  used  by  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

register  int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

i 

float 

Random  distance  abberation. 

Called  By 

Function 

Where  Described 

DistributeBursts 

Section  2.6.3.I.8. 

Table  2.6-24:  RandomDistance  Information. 

2.6.3.1.10  RandomDelay 

RandomDelay  generates  a  random  time  abberation.  The  function  call  is  RandomDelay (). 
Table  2.6-25  describes  the  value  returned  by  this  function. 


1  Return  Values  1 

Return  Value 

Type 

Meaning 

randO  &  0x01  CO 

int 

Random  time  delay. 

Called  By 

Function 

Where  Described 

DistributeBursts 

Section  2.6.3. 1.8. 

Table  2.6-25:  RandomDelay  Information. 

2.6.3.1.11  UpdateSharedMemory 

UpdateSharedMemory  updates  the  record  of  ammo  supply  maintained  in  shared  memory. 
The  function  call  is  UpdateSharedMemory(battery,  fuze).  Table  2.6-26  describes  the 
parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

battery 

int 

Standard  C  type. 

fuze 

int 

Standard  C  type. 
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Internal  Variables 

Variable 

Where  Tvoedef  Declared 

b 

reoister  pointer  to  Batttery 

/simnet/mcc/FSE/FSEhost.h 

i 

short 

Standard  C  type. 

1  Called  Bv  1 

Function 

Where  Described 

FPFReauest 

Section  2.6  3.1.4. 

FireForEffect 

Section  2.6.3.I.3. 

AdiustFire 

Section  2.6.3.I.2. 

Table  2.6.26: 


UpdateSharedMemory  Information. 
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2.7  The  CAS  (Close  Air  Support)  Process 

The  CAS  process  is  responsible  for  conveying  information  about  close  air  support 
missions  from  the  CAS  Macintosh  to  the  outside  world.  The  structure  is  shown  in  Figure 
2.7-1. 

CAS  (Close  Air  Support)  Process 
1.7 


Initialization, 
Communication 
and  Close  Air 
Support 
Missions 


-  cas.c 
1. 7.1.1 


Figure  2.7-1:  SCC  (SIMNET  Control  Console)  Process  Structure. 


Table  2.7-1  shows  the  interprocess  messages  that  are  used  by  the  CAS  process. 


Transaction  Type 


Wlr 


Received 

From 


PlaceBombs 


Sorties 


Sent  To 

In  Response  To 

Mother 

When  sortie 
drops  bombs  on 
battlefield 

One-way 

interaction 


BattieMaster  has  -  number  of  One-way 

allocated  sorties  sorties  interaction 

-  number  of 
sorties  that 
maybe 
preplanned 


Table  2.7-1:  CAS  Interprocess  Message  Information. 

The  CAS  process  is  composed  of  the  Initialization  and  Communication  second  level  CSC. 
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2.7.1  Initialization  and  Communication 

The  CAS  Process  is  initialized  and  told  the  number  of  total  sorties  allowed  and  the  number 
of  sorties  allowed  to  be  preplanned.  It  acts  as  a  liaison  between  the  CAS  Macintosh  and  the 
Mother  process.  If  more  sorties  are  added  by  the  Battlemaster,  the  CAS  process  conveys 
this  new  information  to  the  CAS  Console. 

The  scheduling  of  missions  is  implemented  entirely  within  the  CAS  Macintosh  Console. 
Only  when  a  mission  is  "cleared  hot"  is  the  CAS  process  notified  of  the  mission.  The  CAS 
process  then  uses  the  information  given  to  determine  the  location  of  the  individual 
detonations  on  the  battlefield.  It  looks  to  see  if  titere  are  any  combat  vehicles  close  to  the 
given  location  and  adjusts  the  lun-in  heading  and  location  of  the  bursts  accordingly,  to  try 
to  be  more  representative  of  how  a  real  mission  would  be  adjusted.  When  a  sortie  is  to 
drop  a  bomb,  the  CAS  process  notifies  the  Mother  process  to  report  the  detonation  on  the 
SIMNET  local  area  network.  There  is  one  CSU,  cas.c. 


2.7. 1.1  cas.c 

/simnet/mcc/CAS/cas.c 

cas.c  contains  the  CAS  process,  which  manages  the  CAS  console. 

2. 7. 1.1.1  main 


main  is  the  entry  point  to  the  CAS  process.  The  function  call  is  main(argc,  argv).  Table 
2.7-2  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

arqc 

int 

Standard  C  type. 

basic.hbasic.hargv 

pointer  to  pointer  to  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

InitializeProcess 

Section  2.21.1.19.1. 

OoenHostSocket 

Section  2.21.1.7.1. 

ActivateConsole 

Section  2.21.1.7.2. 

AllotSorties 

Section  2. 7.1. 1.4. 

Alarms  Enabled 

Section  2.21.2.4.4. 

Table  2.7-2:  main  Information. 


2. 7. 1.1. 2  ProcessMessage 

ProcessMessage  processes  a  message  from  another  process,  type  indicates  whether  the 
message  is  a  one-way,  asynchronous  or  sychronous  request,  or  a  response  to  a  previous 
request  kind  indicates  the  type  of  message  which  has  been  received,  length  incticates  the 
length  of  the  data  in  the  message  received,  data  is  a  pointer  to  the  actual  message  data. 
Information  is  extracted  from  the  message  data  based  on  the  kind  of  message.  The  function 
call  is  ProcessMessage(type,  king,  length,  data).  Table  2.7-3  describes  the  parameters 
used,  errors  returned  and  Inunctions  called  using  this  function. 
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Parameter 


e 


kind 


lenoth 


basic.hdata 


Parameters 


mt 


pointer  to  char 


Where  TvDedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C 


Standard  C  type.  _ 


Variable 


alarms  Enabled 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Standard  C  t 


Error  Name 


MCC_UNEXPECTED_MESS 

AGE 


Errors 


Reason  for  Error 


Message  of  unexpected  kind. 


Calls 

Function 

Where  Described 

AlarmsEnabled 

Section  2.21.2.4.4. 

ATPTransact 

Section  2.21.1.7.3. 

CloseSocket 

Section  2.21.2.10.4. 

AllotSorties 

Section  2.7. 1.1 .4. 

ResetClock 

Section  2.7.1 .1.7. 

Table  2.7-3:  ProcessMessage  Information. 

2.7. 1.1.3  Request  Arrived 

RequestArrived  processes  a  transaction  request,  t,  from  the  CAS  console.  The  function 
call  is  RequestArrived(t).  Table  2.7-4  describes  the  parameters  used,  eirors  returned  and 
functions  called  using  this  function. 


Parameter 


basic.ht 


Parameters 


112711 


pointer  to  Transaction 


Where  Tvoedef  Declared 


/si  mnet/mcc/include/bridge .  h 


Error  Name 


MCC  GETREQUEST  FAILE 


Errors 


Reason  for  Error 


ATPGetRequest  failed. 


MCC  UNKNOWN  REQUEST  |  Unknown  request  from  Macintosh. 


Calls 

Function 

Where  Described 

ATPGetReauest 

Section  2.21.1.1.5. 

ProcessGridInfoRequest 

Section  2.21.1.16.1. 

AllotSorties 

Section  2. 7. 1.1. 4. 

BombRequest 

Section  2.7.1. 1.5. 

Table  2.7-4:  RequestArrived  Information. 
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2. 7. 1.1. 4  AllotSorties 

AUotSorties  tells  the  Macintosh  of  sorties  allocated  for  today.  The  function  call  is 
AUotSortiesO.  Table  2.7-5  describes  the  internal  variables  used  and  functions  called  using 
this  function. 


1  Internal  Variables  1 

1  Variable 

Where  Typedef  Declared 

lieq _ _ 

CASSortiesRequeSk 

/si  mnet/mcc/i  nclude/C  AS.  h 

1  Calls  1 

Function 

Where  Described 

ATPPut 

See  console.c  in  Section  2.21.1.7. 

1  Called  Bv  1 

Function 

Where  Described 

ReauestArrived 

Section  2. 7. 1.1. 3. 

ProcessMessaae 

Section  2.7.1. 1.2. 

main 

Section  2.7.1. 1.1. 

Table  2.7-5:  AllotSorties  Information. 

2. 7. 1.1. 5  BombRequest 

BombRequest  processes  a  bombing  request,  t,  from  the  CAS  console.  The  function  call  is 
BombRequest(t).  Table  2.7-6  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

basic,  ht 

pointer  to  Transaction 

/si  mnet/mcc/i  nclude/bridge .  h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

basic.hreq 

pointer  to  CASBombRequest 

/si  mnet/mcc/i  nclude/C  AS .  h 

basic.hmission 

pointer  to  Mission 

/simnet/mcc/CAS/cas.c 

Calls 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SendConsoleResoonse 

Section  2.21.1.7.6. 

deg_to_rad 

Macro  defined  in 

simnet/common/include/qlobal/sim  macros.h. 

DropBombs 

Section  2. 7.1. 1.6. 

Called  By 

Function 

Where  Described 

RequestArrived 

Section  2.71.1.3. 

Table  2.7-6:  BombRequest  Information. 
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2. 7. 1.1. 6  DropBombs 

DropBombs  is  called  when  it  is  time  for  a  sortie  to  drop  its  bombs.  The  function  call  is 
DropBombs(pardm,  a).  Table  2.7-7  describes  the  parameters  used  and  functions  called 
using  this  function. 


Parameters 


Parameter 


ram 


a 


rs 


e 


Alarm 


Where  Tvoedef  Declared 


Standard  C  t 


/simnet/rcs/libioc/alarm.h 


Variable 


basic.hmission 


Internal  Variables 


e 


pointer  to  Mission 


lEni! 


Where  Tvoedef  Declared 


/simnet/mcc/CAS/cas.c 


Calls 

Function 

Where  Described 

SendMCCMsol 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SetAlarm 

Section  2.21.2.4.2. 

Called  B 


Function 

Where  Described 

BombRequest 

Section  2. 7.1. 1.5. 

Table  2.7-7:  DropBombs  Information. 

2. 7. 1.1. 7  ResetClock 

ResetClock  tells  the  CAS  Console  Macintosh  the  time.  The  function  call  is  ResetClock(). 
Table  2.7-8  describes  the  internal  variables  used  and  functions  called  using  this  function. 


Variable 


Internal  Variables 


e 


CASCIockReguest 


Where  Typedef  Declared 


/simnet/mcc/include/CAS.h 


Calls 

Function 

Where  Described 

MacintoshTime 

Section  2.21.1.27.1. 

ATPPut 

Section  2.21.1.7.4. 

Function 


ProcessMessaoe 


Called  B 


Where  Described 


Section  2.7.1. 1.2. 


Table  2.7-8:  ResetClock  Information. 
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2.8 


The  CEW  (Combat  Engineering  Workstation)  Process 


The  Combat  Engineering  Workstation  process  is  responsible  for  the  emplacement  and 
breaching  of  minefields.  The  structure  is  shown  in  Figure  2.8-1. 


CEW  (Comt  at  Engineering  Workstation)  Process 
1.8 


Initializing 

and 

Communications 

1.8.1 


CEW  Asset 
Management 

1.8.2 


1—  main.c 


L  1.8.1. 1 

CEWHost.h 

1.8.1.2 


hasset.h 
1 .8.2.1 


t— asset.c 
1. 8.2.2 


Figure  2,8-1:  CEW  (Combat  Engineering  Workstation) 
Process  Structure. 


2.8.1  Initialization  and  Communication 

The  CEW  Process  opens  a  connection  with  the  CEW  Macintosh  and  then  sends  down  the 
initial  location  of  all  minefields.  It  listens  to  messages  from  the  Mother  process  and  passes 
information  along  to  the  Macintosh.  It  contains  one  CSU,  main.c. 


2. 8. 1.1  main.c 

/simnet/mcc/CEW/main.c 

main.c  contains  routines  for  the  Immediate  Mine  Emplacement  (CEW)  host  process. 

2. 8. 1.1.1  main 

main  is  the  entry  point  to  the  CEW  process.  The  function  call  is  main(argc,  argv).  Table 
2.8-1  describes  the  parameters  used  and  functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Type 

Where  Tvoedef  Declared 

arqc 

int 

Standard  C  type. 

arqv 

pointer  to  pointer  to  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

InitializeProcess 

Section  2.21.1.19.1. 

OpenHostSocket 

Section  2.21.1.7.1. 

ActivateConsole 

Section  2.21.1.7.2. 

AlarmsEnabled 

Section  2.21.2.4.4. 

Table  2.8-1:  main  Information. 


2. 8. 1.1. 2  ProcessMessage 

ProcessMessage  process  a  message  from  another  host  process,  type  indicates  whether  the 
message  is  a  one-way,  asynchronous  or  sychronous  request,  or  a  response  to  a  previous 
request,  land  indicates  the  type  of  message  which  has  been  received,  length  indicates  the 
length  of  the  data  in  the  message  received,  data  is  a  pointer  to  the  actual  message  data. 
Information  is  extracted  from  the  message  data  based  on  the  kind  of  message.  The  function 
call  is  ProcessMessage(type,  kind,  length,  data).  Table  2.8-2  describes  the  parameters 
used,  errors  returned  and  functions  called  using  this  function. 


Parameters 


Parameter 


e 


kind 


lenqth 


data 


Variable 


alarmsEnabled 


IE17^ 


reaisier  pointer  to  char 


Internal  Variables 


e 


Where  Tvoedef  Declared 


Standard  C  type. 


Standard  C  t 


Standard  C  type. 


Standard  C  type. 


Where  Tvoedef  Declared 


Standard  C  type. 


Errors 

Error  Name 

Reason  for  Error 

MCC  UNEXPECTED  MESS 
AGE 

Message  of  an  unexpected  type. 

Calls 

Function 

Where  Described 

AlarmsEnabled 

Section  2.21.2.4.4. 

ATPTransact 

Section  2.21.1.7.3. 

CloseSocket 

Section  2.21.2.10.4. 

ResetClock 

Section  2.8. 1.1. 3. 

AssetReconstituted 

Section  2.8. 2. 2.4. 

AssetKilled 

Section  2.8. 2. 2.5. 

Table  2.8-2:  ProcessMessage  Information. 
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2. 8. 1.1. 3  ResetClock 

ResetClock  updates  the  clock  on  the  CEW  Console  Macintosh.  The  function  call  is 
ResetClockQ.  Table  2.8-3  describes  the  internal  variables  used  and  functions  called  using 
this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

req 

CEWCIockRequest 

/simnet/mcc/include/CEW.h 

1  Calls  1 

Function 

Where  Described 

MacintoshTime 

Section  2.21.1.27.1. 

ATPPut 

Section  2.21.1.7.4. 

1  Called  Bv  1 

Function 

Where  Described 

ProcessMessaqe 

Section  2.8. 1.1 .2. 

Table  2.8-3:  ResetClock  Information. 
2. 8. 1.1. 4  RequestArrived 


RequestArrived  processes  an  ATP  Request,  t,  from  the  CEW  Console  Macintosh.  The 
function  call  is  RequestArrived(t).  Table  2.8-4  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

Errors 

Error  Name 

Reason  for  Error 

MCC  GETREQUEST  FAILE 

D 

ATPGetRequest  failed. 

MCC  UNKNOWN  REQUEST 

Unknown  request  from  Macintosh. 

Calls 

Function 

Where  Described 

ATPGetRequest 

Section  2.21.1.1.5. 

ProcessGridInfoRequest 

Section  2.21.1.16.1. 

InitiafizeAssets 

Section  2. 8. 2. 2.2. 

ProcessBoundsRequest 

Section  2.8. 1.1. 5. 

ProcessEmplaceRequest 

Section  2.8. 1.1. 6. 

ProcessBreachRequest 

Section  2.8. 1.1. 7. 

ProcessSuppIvRequesl 

Section  2.8.1.1.10. 

ProcessDispatch  Request 

Section  2.8. 1.1. 8. 

ProcessArrivalRequest 

Section  2  8.1.1.9. 

Table  2.8-4;  RequestArrived  Information. 
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2. 8. 1.1. 5  ProcessBoundsRequest 

ProcessBoundsRequest  handles  a  request  from  the  CEW  Console  Macintosh  for 
information  about  terrain  boundaries.  The  function  call  is  ProcessBoundsRequest(t). 
Table  2.8-5  describes  the  parameters  used,  errors  returned  and  functions  called  using  this 
function. 


Parameters 


Parameter 


Where  Tvoedef  Declared 


/simnet/mcc/include/bridqe.h 


Variable 


rsp 


Internal  Variables 


e 


register  pointer  to 
CEWBoundsResoonse 


Where  Tvoedef  Declared 


/si  mnet/mcc/include/C  E  W.  h 


Calls 

Function 

Where  Described 

ATPResponseData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

Called  B 


Function 

Where  Described 

RequestArrived 

Section  2.8. 1.1. 4. 

Table  2.8-5:  ProcessBoundsRequest  Information. 

2. 8. 1.1. 6  ProcessEmplaceRequest 

ProcessEmplaceRequest  handles  a  request  from  the  CEW  Console  Macintosh  to  emplace  a 
minefield.  The  function  call  is  ProcessEmplaceRequest(t).  Table  2.8-6  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


Variable 


req 


Parameters 


e 


inter  to  Transaction 


Internal  Variables 


e 


pointer  to 

CEWEmplaceReauest 


pointer  to 

CEWEmplaceResoonse 


MCCMessageBuffer 


Where  Tvoedef  Declared 


/simnet/mcc/include/bridae.h 


Where  Tvoedef  Declared 


/simnet/mcc/includ/CEW.h 


/si  mnet/mcc/i  nclud/C  E  W .  h 


/simnel/mcc/include/MCCJpc 
■  h 


Function 


ATPReauestData 


ATPResponseData 


SendMCCMsol 


SendConsoleResponse 


Calls 


Where  Described 


Macro  defined  in  /simnet/mcc/include/bridae.h. 


Macro  defined  in  /simnet/mcc/include/bridae.h. 


Macro  defined  in  /simnet/mcc/include/MCC  i 


Section  2.21.1.7.6. 
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Called  Bv 

Function 

Where  Described 

RequestArrived 

Section  2.8. 1.1. 4. 

Table  2.8-6:  ProcessEmplaceRequest  Information. 


2. 8. 1.1. 7  ProcessBreachRequest 


ProcessBreachRequest  handles  a  request,  t,  from  the  CEW  Console  Macintosh  to  breach  a 
minefield.  The  function  call  is  ProcessBreachRequest(t).  Table  2.8-7  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

req 

pointer  to 

CEWBreachRequest 

/simnet/mcc/includ/CEW.h 

rsp 

pointer  to 

CEWBreachResponse 

/si  mnet/mcc/i  nciud/C  E  W .  h 

msg 

MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

ATPResponseData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SerdMCCMsql 

Macro  defined  in  /simnet/mcc/inciude/MCC  ipc.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

1  Called  By  I 

Function 

Where  Described 

RequestArrived 

Section  2  8.1.1.4. 

Table  2.8-7:  ProcessBreachRequest  Information. 


2. 8. 1.1. 8  ProcessDispatchRequest 

ProcessDispatchRequest  handles  a  request,  t,  from  the  CEW  Console  Macintosh  to  hide  a 
CCV  vehicle  being  ^spatched.  The  function  call  is  ProcessDispatchRequest(t).  Table 
2.8-8  describes  the  parameters  used,  errors  returned  and  functions  called  using  this 
function. 


BBN  Systems  and  Technologies 


Variable 


req 


Internal  Variables 


e 


pointer  to 

CEWDisoatchReouest 


pointer  to 

CEWDisoatchResoonse 


MCCMessageBuffer 


MCC  CSCI 


Where  Tvoedef  Declared 


/simnet/mcc/includ/CEW.h 


/simnet/mcc/includ/CEW.h 


/simnet/mcc/include/MCCJpc 

.h 


Function 


ATPRequestData 


ATPResponseData 


HideCCV 


SendConsoleResponse 


Calls 


Where  Described 


Macro  defined  in  /simnet/mcc/include/bndqe.h. 


Macro  defined  in  /simnet/mcc/include/bridqe.h. 


Section  2.21.1.6.2. 


Section  2.21.1.7.6. 


Called  B 


Function 

Where  Described 

RequestArrived 

Section  2.8. 1.1. 4. 

Table  2.8-8:  ProcessDispatchRequest  Information. 

2.8. 1.1.9  ProcessArrivalRequest 

ProcessAnivalRequest  handles  a  request  from  the  CEW  Console  Macintosh  to  show  an 
arrived  CCV  vehicle.  The  function  call  is  ProcessArrivalRequest(t).  Table  2.8-9  describes 
the  parameters  used  and  functions  called  using  this  function. 


Parameter 


Variable 


markin 


Parameters 


inter  to  Transaction 


Internal  Variables 


e 


inter  to  CEWArrivalRequest 


pointer  to 

CEWArrivalResoonse 


M  CC  M  essage  Buffer 


pointer  to  CCVStatus 


VehicleMarkin 


Where  Tvoedef  Declared 


/simnet/mcc/include/bndae.h 


Where  Tvoedef  Declared 


/si  mnet/mcc/i  nclud/C  E  W .  h 


/simnet/mcc/includ/CEW.h 


/simnet/mcc/include/MCCJpc 

.h 


/simnet/mcc/include/vehjabi 

.h 


basic,  h 


Function 


ATPRequestData 


ATPResponseData 


DisplavCCV 


SendConsoleResponse 


Calls 


Where  Described 


Macro  defined  in  /simnet/mcc/include/bridge.h. 


Macro  defined  in  /simnet/mcc/include/bridqe.h. 


Section  2.21.1.6.1. 


Section  2.21.1.7.6. 
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1  Called  Bv  1 

Function 

Where  Described 

RequestArrived 

Section  2. 8. 1.1. 4. 

Table  2.8*9:  ProcessArrivalRequest  Information. 


2.8.1.1.10  ProcessSupplyRequest 


ProcessSupplyRequest  handles  a  request  from  the  CEW  Console  Macintosh  to  supply  a 
CEW.  The  function  call  is  ProcessSupplyRequest(t).  Table  2.8-10  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

t 

pointer  to  Transaction 

/simnet/mcc/include/bridqe.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

req 

pointer  to 

CEWSupplyRequest 

/si  mnet/mcc/i  nclud/C  E  W.  h 

rsp 

pointer  to 

CEWSuppIvResponse 

/si  mnet/mcc/i  nclud/C  E  W.  h 

msg 

MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

temp 

CEWSuppIvRequest 

/si  mnet/mcc/i  nclud/CEW.h 

1  Calls  1 

Function 

Where  Described 

ATPRequestData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

ATPResponseData 

Macro  defined  in  /simnet/mcc/include/bridqe.h. 

SendMCCMsql 

Macro  defined  in  /simnet/mcc/include/MCC  ipc.h. 

SendConsoleResponse 

Section  2.21.1.7.6. 

1  Called  By  1 

Function 

Where  Described 

RequestArrived 

Section  2.8. 1.1. 4. 

Table  2.8-10:  ProcessSupplyRequest  Information. 


2.8. 1.2  CEWHost.h 

/simnet/mcc/CEW/CEWHost.h 


CEWHost.h  defines  structures  used  by  the  CEW  process.  Table  2.8- 1 1  describes  the 
variables  used  by  CEWHost.h. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

cewCCVState 

extern  array  of  TruckState 

/simnet .  mcc/C  E  W/C  E  WHost .  h 

Table  2.8-11:  CEWHost.h  Variable  Information. 
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2.8.2  CEW  Asset  Management 


2.8.2. 1  asset. h 

/simnel/mcc/CEW/asset.h 

asset.h  is  the  header  file  associated  with  assetc.  Section  2.8.2.2. 


2. 8. 2. 2  asset. c 

/simnet/mcc/CEW/asset.c 


asset.c  contains  routines  for  coordinating  CEW  assets.  Table  2.8-12  describes  the 
variables  used  by  asset.c. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

assetTable 

/simnet/mcc/CEW/asset.c 

Table  2.8-12:  asset.c  Variable  Information. 
2. 8. 2. 2.1  LookupAssetNumber 


LookupAssetNumber  finds  an  asset  record  in  the  assetTable,  given  kind  and  number.  The 
function  call  is  LookupAssetNumber(kind,  number).  Table  2.8-13  describes  the 
parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

kind 

int 

Standard  C  type. 

number 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

assetTable[i]. start  +  number 

long 

The  asset  record. 

0 

long 

Error  occured. 

1  Called  By  1 

Function 

Where  Described 

AssetReconstituted 

Section  2.8.2.2.4. 

Table  2.8-13:  LookupAssetNumber  Information. 
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2. 8. 2. 2. 2  InitializeAssets 

InidalizeAssets  is  called  when  the  CEW  is  initially  spawned  to  read  information  in  shared 
memory  which  has  been  initialized  by  the  SCC.  TTie  SCC  has  already  allocated  the  assets 
available  to  the  CEW.  InitializeAssets  notifies  the  CEW  Console  Macintosh  of  all  the 
resources  which  have  been  allocated.  The  function  call  is  InitializeAssetsQ.  Table  2.8-14 
describes  the  internal  variables  used  and  functions  called  using  this  function. 


Variable 


kind 


GetCEWParametersO 


lEiT? 


Internal  Variables 


e 


Function  that  returns  pointer 
to  CEWParameters 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Section  2.21.1.8.1. 


Function 


GetCEWParameters 


InitializeAsset 


ATPTransact 


Calls 


Where  Described 


Section  2.21.1.8.1. 


Section  2.8. 2.2.3. 


Section  2.21.1.7.3. 


Called  B 


Function 

Where  Described 

RequestArrived 

Section  2.8. 1.1. 4. 

Table  2.8-14:  InitializeAssets  Information. 

2. 8. 2. 2. 3  InitializeAsset 

InitializeAsset  initializes  one  CEW  asset  by  notifying  the  CEW  Console  Macintosh  of  its 
existence.  ccvNumber  is  a  unique  ID  for  the  vehicle  (it  is  an  index  into  the  CCV  truck 
array),  kind  is  the  kind  of  CEW  CCV  vehicle,  and  pars  describes  the  CEW  parameters  for 
that  asset.  The  function  call  is  InitializeAsset(ccvNumber,  kind,  pars).  Table  2.8-15 
describes  the  parameters  used  and  functions  c^led  using  this  function. 


Parameter 


ccvNumber 


kind 


pars 


Variable 


guises 


marking 


capabilities 


Parameters 


e 


int 


short 


pointer  to  CEWParameters 


Internal  Variables 


e 


CEWAssetlnitReouest 


VehicleGuises 


VehicleMarking 


VehicleCapabilities 


pointer  to  CCVStatus 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


/simnet/mcc/include/MCC_par 

s.h 


Where  Tvoedef  Declared 


/simnet/mcc/include/CEW.h 


/simnet/common/include/prot 

ocol/basic.h 


/simnet/common/include/prot 

ocol/basic.h 


/simnet/common/include/prot 

ocol/basic.h 


/simnet/mcc/include/veh_tabl 

.h 
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_ _ Calls 

Function  I  Where  Described 

DisplavCCV _ Section  2.21.1 .6.1. 

ATPTransact_ Section  2.21.1 .7,3. 


_ _ Called  By _ 

Function _ Where  Described _ 

Initialize  Assets  Section  2.8.2.2.2. 

Table  2.8-15:  InitializeAsset  Information. 

2. 8. 2. 2. 4  AssetReconstituted 

AssetReconstituted  is  called  when  the  SCC  notifies  the  CEW  process  that  one  of  its  CCVs 
has  been  reconstituted.  The  CEW  process  must  notify  the  CEW  Console  Macintosh  that 
this  has  occured  via  an  assetinit  message.  The  function  call  is  AssetReconstituted(msg). 
Table  2.8-16  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


msg 


Variable 


Parameters 


e  Where  Tyoedef  Declared 


pointer  to  MCCMessageBuffer  /simnet/mcc/include/MCCJpc 

.h 


lElT! 


marking 


capabilities 


Internal  Variables 


e 


CEWAssetReconstReauest 


pointer  to  CCVStatus 


pointer  to  CEWParameters 


VehicleMarking 


VehicleCapabilities 


Where  Typedef  Declared 


/simnet/mcc/include/CEW.h 


/simnet/mcc/include/vehjabi 

e.h 


/simnet/mcc/i  nclude/M  CC_par 
s.h 


/simnet/common/include/prot 

ocol/basic.h 


/simnet/common/include/prot 

ocol/basic.h 


Function 


LookupAssetNumber 


GetCEWParameters 


DisplavCCV 


ATPTransact 


Calls 


Where  Described 


Section  2.8.2.2.I. 


Section  2.21.1.8.1. 


Section  2.21.1.6.1. 


Section  2.21.1.7.3. 


Called  B 


Function 

Where  Described 

ProcessMessaqe 

Section  2  8.1.1.2. 

Table  2.8-16:  AssetReconstituted  Information. 
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2. 8. 2. 2. 5  AssetKilled 

AssetKilled  is  called  when  the  Mother  process  notifies  the  CEW  process  that  one  of  its 
CCVs  has  been  killed.  The  CEW  process  must  notify  the  CEW  Console  Macintosh  that 
this  has  occured  via  an  assetStatus  message.  The  function  call  is  AssetKilled(msg).  Table 
2.8-17  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Tvoedef  Declared 

msg 

pointer  to  MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

req 

CEWAssetStatusRequesl 

/si  mnet/mcc/include/C  E  W.  h 

1  Calls  1 

Function 

Where  Described 

ATPTransact 

Section  2.21.1.7.3. 

1  Called  Bv  1 

Function 

Where  Described 

ProcessMessaqe 

Section  2.8.1. 1.2. 

Table  2.8-17:  AssetKilled  Information. 
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The  Terminal  process  consists  of  seven  second  level  CSCs: 

Command  Line  Interface 
Clock  Reset  Command 
Interprocess  Communication 
Performance  Monitor  Command 
Process  Monitor  Command 
Status  Report  Command 
Simulator  Save/Restore 
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2.9.1  Command  Line  Interface 

The  command  line  interface  is  a  simple  line-oriented  interface.  Commands  are  simple 
English  phrases  terminated  by  a  new  line.  The  CLI  parses  command  lines  and  dispatches 
the  appropriate  routine  to  display  the  requested  information.  The  CLI  also  contains  code  to 
send  a  restart  request  message  to  the  Admin/Log,  Maintenance,  Fire  Support,  and  Close 
Air  Support,  so  Aat  those  Macintosh  consoles  may  be  restarted  in  the  event  of  a  power 
glitch  or  other  failure.  It  contains  three  CSU's:  main.c,  cmd.c,  and  parser.c. 


2.9. 1.1  main.c 

/simnet/mcc/rerminal/main.c 


main.c  contains  most  of  the  Terminal  process.  It  accepts  and  processes  commands  from 
the  MCC  host’s  console  terminal.  Table  2.9-1  describes  the  variables  used  by  main.c. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

Stopped 

int 

Standard  C  type. 

terminal  disabled 

int 

Standard  C  type. 

cardMemorv 

pointer  to  Card  Memory  t 

/si  mnet/nncc/T  erminal/mai  n  .c 

done 

int 

Standard  C  type. 

channel 

int 

Standard  C  type. 

Table  2.9-1:  main.c  Variable  Information. 


2. 9. 1.1.1  Terminal_Handler 

Terminal_Handler  handles  '^Z’s  typed  at  the  keyboard.  The  function  call  is 
Terminal_Handler().  This  function  calls  only  standard  functions  and  is  not  called  by  any 
other  function  in  this  CSC,  so  no  table  is  included  for  it. 

2. 9. 1.1. 2  Quit_Handler 

Quit_Handler  is  called  when  the  MCC  process  is  terminated.  The  function  call  is 
Quit_HandIer().  Table  2.9-2  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

SendMCCMsqO 

Macro  defined  in  /simneVmcc/include/bridge.h. 

Table  2.9-2:  Quit_Handler  Information. 


2. 9. 1.1. 3  main 


main  is  the  entry  point  to  the  Terminal  process.  The  function  call  is  main(argc,  argv). 
Table  2.9-3  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

a  roc 

int 

Standard  C  type. 

arqv 

pointer  to  pointer  to  char 

Standard  C  type. 
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1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

cp 

reoister  pointer  to  char 

Standard  C  type. 

saveCmdBuf 

array  256  of  char 

Standard  C  type. 

cmdBuf 

array  256  of  char 

Standard  C  type. 

cmd 

array  256  of  char 

Standard  C  type. 

params 

array  256  of  char 

Standard  C  type. 

part 

array  40  of  char 

Standard  C  type. 

par2 

array  40  of  char 

status 

char 

Standard  C  type. 

cardMemorySize 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

InitializeProcess 

Section  2.21.1.19.1. 

net  hostbuf  info 

Section  2.20.2.6.1. 

parser  init 

Section  2.9. 1.3.1. 

tty  tick 

parser  restore  term 

Section  2.9. 1.3.2. 

CloseSocket 

Section  2.21.2.10.4. 

Table  2.9-3:  main  Information. 


2.9. 1.2  cmd.c 

simnet/mcc/Terminal/cmQ.c 


cmd.c  contains  the  command  line  interface  dispatcher  routines.  Table  2.9-4  describes  the 
variables  used  by  cmd.c. 


1  Variables  I 

Variable 

Where  Typedef  Declared 

terminal  disabled 

int 

Standard  C  type. 

cardMemory 

extern  pointer  to 

Card  Memory  t 

simnet/mcc/Termi  nal/mai  n  c 

done 

extern  int 

Standard  C  type. 

networkinterface 

extern  int 

Standard  C  type. 

Table  2,9-4:  cmd.c  Variable  Information. 


2. 9. 1.2.1  cmdsendbreach 

cmd_send_breach  performs  the  command  line  action  of  creating  a  breached  lane.  The 
function  call  is  cmd_send_breach(argc,  argv).  Table  2.9-5  describes  the  parameters  used, 
errors  returned  and  functions  called  using  this  function. 


Parameter 


c 


Parameters 


inter  to  array  of  Char 


Where  Tyoedef  Declared 


Standard  C  type. 


Standard  C  type. 
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1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

msg 

MCCMessageBuffer 

/simnet/mcc/include/mcc  ipc. 
h 

1  Calis  1 

Function 

Where  Described 

SendMCCMsgl 

macro  defined  in  /simnet/mcc/include/bridqe.h 

1  Called  Bv  1 

Function 

Where  Described 

"MCC  Commands” 
top  command  table 

/si  mnet/mcc/T  erminal/parser.c 

Table  2.9-5:  cmd  send  breach  Information. 


2. 9. 1.2. 2  cmd_clock 

cmd_clock  performs  the  command  line  action  of  changing  the  Macintosh  system  clocks. 
The  function  call  is  cmd_clock(argc,  argv).  Table  2.9-6  describes  the  parameters  used, 
errors  returned  and  functions  call^  using  this  function. 


Parameters 


Parameter 


c 


Function 


ClockCommand 


inter  to  array  of  char 


Calls 


Where  Described 


Section  2.9. 2. 1.1. 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Called  B 


Function 

Where  Described 

"MCC  Commands" 
top  command  table 

/si  mn  et/mcc/T  ermi  nal/parser.c 

Table  2.9-6;  cmd  clock  Information. 


2. 9. 1.2. 3  cmd  disable 


cmd_disable  performs  the  command  line  action  of  disabling  the  Terminal  Input.  The 
function  call  is  cmd_disable(argc,  argv).  Table  2.9-7  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 
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Called  By 

Function 

Where  Described 

"MCC  Commands" 
top  command  table 

/simnet/mcc/T  erminal/parser.c 

Table  2.9-7:  cmd  disable  Information. 


2.9. 1.2.4  cmd_exit 

cmd_exit  performs  the  command  line  action  of  exiting  the  MCC  and  deactivating  any 
activated  simulators.  The  function  call  is  cmd_exit(argc,  argv).  Table  2.9-8  describes  the 
parameters  used,  errors  returned  and  functions  called  using  this  function. 


Parameter 


Function 


SendMCCMsaO 


Parameters 


inter  to  array  of  char 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  type. 


Calls 


Where  Described 


macro  defined  in  /simnet/mcc/include/bndae.h 


Called  B 


Function 

Where  Described 

"MCC  Commands" 
top  command  table 

/simnet/mcc/Terminal/parser.c 

Table  2.9-8:  cmd  exit  Information. 


2.9. 1.2.5  cmd  list 


cmd_list  performs  the  command  line  action  of  listing  the  simulator  save  files  in  a  given 
directory.  The  function  call  is  cmd_clock(argc,  argv).  Table  2.9-9  describes  the 
parameters  used,  errors  returned  and  functions  called  using  this  function. 


_ _ Parameters _ _ 

Parameter  I  Tvoe  I  Where  Tvoedef  Declared 


Function _ Where  Described 

SimListSaves   Section  2.9.7. l.i. 


Called  B 


Function 

Where  Described 

"MCC  Commands" 
top  command  table 

/si  mnet/mcc/T  errr^nal/parser.c 

Table  2.9-9:  cmd  list  Information. 
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2. 9. 1.2. 6  cind_perf 


cmd_perf  performs  the  command  line  action  of  showing  MCC  performance  data.  The 
function  call  is  cmd_perf(argc,  argv).  Table  2.9-10  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

arac 

int 

Standard  C  type. 

arav 

pointer  to  array  of  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

ReoortPertormance 

Section  2.9.4.1.1. 

1  Called  Bv  1 

Function 

Where  Described 

"MCC  Commands" 
top  command  Jable 

/si  mnet/mcc/T  erminal/parser.c 

Table  2.9-10:  cnid_perf  Information. 


2.9. 1.2.7  cmd  restart 


cmd_restart  performs  the  command  line  action  of  restarting  a  Macintosh  console.  The 
function  call  is  cmd_restart(argc,  argv).  Table  2.9-1 1  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 


I  Parameters  I 

■  Parameter  I 

Type 

Where  Typedef  Declared 

int 

Standard  C  type. 

■  argv 

pointer  to  array  of  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

console 

register  pointer  to  struct 
ConsoleName 

msq 

MCCMessageBuffer 

Calls 

Function 

Where  Described 

SendMCCMsgl 

macro  defined  in  /simnet/mcc/include/bridge.h 

1  Called  By  I 

Function 

Where  Described 

"MC  Commands" 
top  command  table 

/simnet/mcc/Terminal/parser.c 

Table  2.9-11:  cmd  restart  Information. 


223 


BBN  Systems  and  Technologies 


MCC  CSCI 


2. 9. 1.2. 8  cind_restore 

cmd_restore  performs  the  command  line  acticm  of  restoring  a  simulator  save  file.  The 
function  call  is  cmd_restore(argc,  argv).  Table  2.9-12  describes  the  parameters  used, 
errors  returned  and  functions  c^ed  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

aroc 

int 

Standard  C  type. 

arqv 

pointer  to  array  of  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

SimRestoreAll 

Section  2.9.7.1.3. 

Called  By 

Function 

Where  Described 

"MCC  Commands" 
top  command  file 

/si  mnet/mcc/T ermi  nal/parser.c 

Table  2.9-12:  cmd_restore  Information. 

2.9. 1.2.9  cmd_save 

cmd_save  performs  the  command  line  action  of  saving  a  simulator  save  file.  The  function 
call  is  cmd_save(argc,  argv).  Table  2.9-13  describes  the  parameters  used,  errors  returned 
and  functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

arqc 

int 

Standard  C  type. 

argv 

pointer  to  array  of  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

SimSaveAll 

Section  2.9.7.I.2. 

Called  By 

Function 

Where  Described 

"MCC  Commands" 
top  command  table 

/simnet/mcc/T  erminal/parser.c 

Table  2.9-13;  cmd_save  Information. 

2.9.1.2.10  cmd_status_all 

cmd_status_all  provides  command  line  status  information  about  the  MCC  and  network. 
The  function  call  is  cmd_status_all(argc,  argv).  Table  2.9-14  describes  the  parameters 
used,  errors  returned  and  functions  called  using  this  function. 
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Parameters 


Parameter 


inter  to  array  of  char 


Where  TvDedef  Declared 


Standard  C  t 


Standard  C  t 


Function 


ReDortIPCStatus 


net  pnnt  statistics 


ProcessStatus 


SimStatusReoort 


ReportYUMMStatus 


Calls 


Where  Described 


Section  2.9.3.1.I. 


Section  2.20.2.5.4. 


Section  2.9.5.I.I. 


Section  2.9.6.1.I. 


Section  2.21.2.10.12 


Called  B 


Function 

Where  Described 

"Status  Commands" 
status  command  table 

/simnet/mcc/Terminai/parser.c 

Table  2.9-14:  cmd_status_all  Information. 

2.9.1.2.11  cmd_status_bumper 

cmd_status_bumper  provides  command  line  status  information,  specified  by  its  bumper 
number,  about  the  simulator.  The  function  call  is  cmd_status_bumper(argc,  argv).  Table 
2.9-15  describes  the  parameters  used,  errors  returned  and  functions  called  using  this 
function. 


Parameters 


Parameter 


inter  to  array  of  char 


where  Tvoedef  Declared 


Standard  C  t 


Standard  C  type. 


Function 


VehFromBumper 


SimStatusReoort 


Calls 


Where  Described 


Section  2.9.7.I.5. 


Section  2.9.6.I.I. 


Called  B 


Function 

Where  Described 

"Status  Commands" 
status  command  table 

/simnet/mcc/Terminal/parser.c 

Table  2.9-15:  cmd_status_bumper  Information. 

2.9.1.2.12  cmd_status_ip': 

cmd_status_ipc  provides  command  line  status  information  about  the  ipc  parameters.  The 
function  call  is  cmd_restore(argc,  argv).  Table  2.9-16  describes  the  parameters  used, 
errors  returned  and  functions  cdled  using  this  function. 
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Parameter 


irs 


Parameters 


inter  to  array  of  char 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Function 


ReportlPCStatus 


Calls 


Where  Described 


Section  2.9.3.I.1. 


Called  B 


Function 

Where  Described 

"Status  Commands" 
status  command  table 

/simnet/mcc/T erminal/parser.c 

Table  2.9*16:  cnid_status_ipc  Information. 

2.9.1.2.13  cmd_status_net 

cmd_status_net  provides  command  line  status  information  about  the  simulation  network. 
The  function  call  is  cmd_status_net(argc,  argv).  Table  2.9-17  describes  the  parameters 
used,  errors  returned  and  functions  called  using  this  function. 


Parameters 


Parameter 


inter  to  array  of  char 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  type. 


Function 


net  print  statistics 


Calls 


Where  Described 


Section  2.20.2.5.4 


Called  B 


Function 

Where  Described 

"Status  Commands" 
status  command  table 

/simnet/mcc/Terminal/parser.c 

Table  2.9-17:  cmd_status_net  Information. 
2.9.1.2.14  cmd_status_process 


cmd_status_process  provides  command  line  status  information  about  the  MCC  processes. 
The  function  call  is  cmd_status_process(argc,  argv).  Table  2.9-18  describes  the 
parameters  used,  errors  returned  and  functions  cdl^  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

aroc 

int 

Standard  C  type. 

arov 

pointer  to  array  of  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

ProcessStatus 

Section  2.9.5. 1.1 
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Called  B 


Function 

Where  Described 

"Status  Commands" 
status  command  table 

/si  mnet/mcc/Terminal/parser.c 

Table  2.9>18:  cmd_status_process  Information. 
2.9.1.2.15  cmd  status  sim 


cmd_status_sim  provides  command  line  status  information  about  a  specified  simulator. 
The  function  call  is  cmd_restore(argc,  argv).  Table  2.9-19  describes  the  parameters  used, 
errors  returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Tvoedef  Declared 

aroc 

int 

Standard  C  type. 

arov 

pointer  to  array  of  char 

Standard  C  type. 

internal  Variables 

Variable 

Where  Typedef  Declared 

sim 

SimulatorStatus 

/simnet/mcc/include/veh_tabl 

e.h 

1  Calls  1 

Function 

Where  Described 

VehFromSimNum 

Section  2.9.7. 1.4. 

SimStatusReport 

Section  2.9.6.I.I. 

1  Called  By  I 

Function 

Where  Described 

"Status  Commands" 
status  command  line 

/simnet/mcc/T  ernrenal/parser.c 

Table  2.9-19:  cmd  status  sim  Information. 


2.9.1.2.16  cmd_status_sims 

cmd_status_sims  provides  command  line  status  information  about  this  MCCs  simulators. 
The  function  call  is  cmd_status_sims(argc,  argv).  Table  2.9-19  describes  the  parameters 
used,  errors  returned  and  functions  caJl^  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

SimStatusReport 

Section  2.9.61.1. 

Called  Bv 

Function 

Where  Described 

"Status  Commands" 
status  command  line 

/simnet/mcc/Terminal/parser.c 

Table  2.9-19:  cmd  status  sims  Information. 


2.9.1.2.17  cmd_status_vid 

cmd_status_vid  provides  command  line  status  information  about  the  simulator,  specified  by 
its  vehicle  ID  number.  The  function  call  is  cmd_status_vid(argc,  argv).  Table  2.9-20 
describes  the  parameters  used,  errors  returned  and  functions  c^led  using  this  function. 


Parameter 


Parameters 


inter  to  arrav  of  char 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Variable 


vehicle!  D 


Internal  Variables 


e 


VehiclelO 


Where  Typedef  Declared 


/simnet/common/include/prot 

ocol/basic.h 


Function 


VehicleStatusReport 


Calls 


Where  Described 


Section  2.9.6.1.2 


Called  B 


Function 

Where  Described 

"Status  Commands" 
status  command  line 

/simnet/mcc/T  erminal/parser.c 

Table  2.9-20:  cmd  status  vid  Information. 


2.9.1.2.18  cmd_status_yumm 

cmd_status_yumm  provides  command  line  status  information  about  the  YUMM  internals. 
The  function  call  is  cmd_status_yumm(argc,  argv).  Table  2.9-21  describes  the  parameters 
used,  errors  returned  and  functions  called  using  this  function. 
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Called  Bv 

Function 

Where  Described 

'Status  Commands' 
status  command  line 

/si  mnet/mcc/T  erminal/parser.c 

Table  2.9*21:  cmd_status_yunini  Information. 


2.9.1.2.19  cmd  trace 


cmd_trace  performs  the  command  line  action  of  tracing  network  messages  and  internal 
messages.  The  function  call  is  cmd_trace(argc,  argv).  Table  2.9-22  describes  the 
parameters  used,  errors  returned  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvnedef  Declared 

aroc 

int 

Standard  C  type. 

arav 

pointer  to  array  of  char 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

CP 

reqister  pointer  to  char 

Standard  C  type. 

1  Called  Bv  1 

Function 

Where  Described 

'MCC  Commands' 
top  command  table 

/simnet/mcc/Terminal/parser.c 

Table  2.9*22:  cmd  trace  Information. 


2.9. 1.3  parser.c 

simnet/mcc/Terminal/parser.c 

parser.c  is  a  command  line  interpreter  definition  file.  It  defines  the  commands  available  on 
the  MCC  host  console,  parser.c  utilizes  the  libparser  interface  file  to  define  the  commands, 
options,  and  values  which  can  be  entered  at  the  command  line.  Through  libparser,  the 
commands  defined  in  parser.c  are  checked  for  validity,  and  the  corresponding  action 
routine  in  cmd.c  is  invoked.  Table  2.9-23  describes  the  variables  us^  by  parser.c. 


1  Variables  1 

Variable 

Where  Tvpedef  Declared 

top_command_table 

extern  array  of 

PARSE  TABLE 

parser.h  (for  libparser) 

Table  2.9*23:  parser.c  Variable  Information. 
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2. 9. 1.3.1  parser_init 

parser_init  intializes  the  parser.  The  function  call  is  parser_init().  Table  2.9-24  describes 
the  parameters  used,  errors  returned  and  functions  c^led  using  this  function. 


1  Calls  1 

Function 

1  Where  Described  1 

ttv  parser  init 

1  Called  Bv  1 

Function 

Where  Described 

main 

Section  2.9.1 .1.3 

Table  2.9-24:  parser_init  Information. 

2.9. 1.3.2  parser_restore_term 

parser_restore_term  restores  the  terminal  process.  The  function  call  is 
parser_restore_term().  Table  2.9-25  describes  the  parameters  used,  errors  returned  and 
f^unctions  called  using  this  function. 


I  Calls  I 

Function 

I  Where  Described  I 

ttv  exit 

I  Called  Bv  I 

Function 

Where  Described 

main 

Section  2.9. 1.1 .3. 

cmd  disable 

Section  2.9. 1.2.3. 

Table  2.9-25:  parser_restore_term  Information. 

2.9.2  Clock  Reset  Command 

The  Clock  Reset  Command  allows  an  operator  to  change  the  Time-Of-Day  clock  on  the 
MCC  host  system  and  all  of  the  Macintosh  Consoles.  TTiis  is  sometimes  necessary  due  to 
normal  clock  skew  so  that  operations  among  the  MCC  components  will  remain 
synchronized.  This  functionality  is  realized  by  one  CSU,  clock.c. 


2.9.2.1  clock.c 

simnet/mcc/rerminal/clock.c 

clock.c  contains  functions  which  control  the  MCC  clocks.  Table  2.9-26  describes  the 
variables  used  by  clock.c. 


1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

month  to  day 

array  12  of  int 

Standard  C  type. 

Table  2.9-26:  clock.c  Variable  Information. 
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2.9.2. 1.1  ClockCommand 

ClockCommand  resets  the  clock  on  the  Masscomp  computer  and  on  all  of  the  consoles. 
The  function  call  is  ClockCommand(params).  Table  2.9-27  describes  the  parameters  used 
and  functions  called  using  this  function. 


Parameters 


Parameter 


arams 


time  desc 


cur  time 


new  time 


month 


arqs  read 


date  Qiven 


inter  to  char 


Where  Typedef  Declared 


Standard  C  t 


Internal  Variables 

Variable 

Where  Tvoedef  Declared 

msg 

MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

irs 


inter  to  struct  tm 


time  t 


time  t 


int 


int 


int 


int 


int 


short 


short 


short 


Standard  C  Libra 


Standard  C  Libra 


Standard  C  Libra 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  tvoe. 


Standard  C  t 


Standard  C  tvoe. 


Function 


LocalToGMTTime 


MCC  SvstemError 


SendMCCMsoO 


Calls 


Where  Described 


Section  2.9.2.I.2. 


Section  2.21.1.11.3. 


Macro  defined  in  /simnet/mcc/include/biidqe.h. 


Function 


cmd  clock 


Called  B 


Where  Described 


Section  2.9. 1.2.2. 


Table  2.9-27:  ClockCommand  Information. 

2.9.2.1.2  LocalToGMTTime 

LocalToGMTTime  converts  the  local  time,  time,  into  GMT  time.  The  function  call  is 
LocalToGMTTime(time).  Table  2.9-28  describes  the  parameters  used  and  functions  called 
using  this  function. 
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Table  2.9-28:  LocalToGMTTime  Information. 


2.9.3  Interprocess  Communication  Status  Command 

The  status  of  all  ipc  facilities  used  by  the  MCC  may  be  reported  using  this  command.  It 
displays  the  status  of  semaphores  used  by  internal  message  passing  routines,  message 
queues,  parameter  tables,  vehicle  simulator  status  tables,  and  AppleTalk  packet  information 
tables.  Information  such  as  processes  attached  to  shared  sections  and  outstanding 
messages  are  available.  There  is  one  CSU,  ipc.c. 

2.9.3.1  ipc.c 

/simnet/mcc/TerminalAipc  .c 

ipc.c  contains  routines  for  checking  the  status  of  the  interprocess  communication  facilities 
used  by  the  MCC.  Table  2.9-29  describes  the  variables  used  by  ipc.c. 


Variable 


localtime 


Variables 


e  Where  Tvoedef  Declared 


extern  pointer  to  struct  tm  Standard  C  Library  function. 


Table  2.9-29;  ipc.c  Variable  Information. 


2. 9. 3. 1.1  ReportIPCStatus 

ReportIPCStatus  reports  the  status  of  all  the  ipc  facilities  used  by  the  MCC.  The  function 
call  is  ReportIPCStatus().  Table  2.9-30  describes  the  functions  called  using  this  function. 


Function 


DisplavSemStatus 


DisplavShmStatus 


DisplavMsaOStatus 


Calls 


Where  Described 


Section  2.9.3. 1.3. 


Section  2.9.3. 1.2. 


Section  2.9.3. 1.4. 


Table  2.9-30:  ReportIPCStatus  Information. 
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2.9.3. 1.2  DisplayShmStatus 

DisplayShmStatus  displays  the  shared  memory  status  for  various  facilities  used  by  the 
MCC,  including  the  YUMM,  Vehicle  Table,  Parameter  Table  and  AppleTalk  Info,  key 
determines  which  shared  memory  will  have  its  status  displayed.  The  function  call  is 
Displays hmStatus(key).  Table  2.9-31  describes  the  parameters  used  and  functions  called 
using  this  function. 


Parameters 


Parameter 


1013 


e 


key  t 


Where  Tvoedef  Declared 


/u  sr/i  nclude/s  vs/t  voes .  h 


Variable 


shmid 


but 


lastProcess 


status 


time 


Internal  Variables 


e 


mt 


stmct  shmid  ds 


int 


int 


inter  to  struct  tm 


ID73 


113 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  tvoe. 


Standard  C  type. 


Standard  C  Libra 


Function 


MCC  SystemError 


LookupProcessIdentifier 


Calls 


Where  Described 


Section  2.21.1.11.3. 


Section  2.21.1.26.2. 


Called  B 


Function 

Where  Described 

ReportlPCStatus 

Section  2.9.3.I.I. 

Function 


cmd  status  all 


cmd  status  ipc 


Called  B 


Where  Described 


Section  2.9.1.2.10. 


Section  2.9.1.2.12. 


Table  2.9*31:  DisplayShmStatus  Information. 

2.9.3. 1.3  DisplaySemStatus 

DisplaySemStatus  is  used  to  display  the  YUMM  and  MCC  Semaphore  status,  key 
determines  which  status  will  be  displayed.  The  function  call  is  DisplaySemStatus(key, 
num).  Table  2.9-32  describes  the  parameters  used  and  functions  called  using  this  function. 
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Variable 


semid 


semnum 


buf 


lastO 


lastMCCO 


status 


cur  count 


value 


zero  count 


otime 


Internal  Variables 


e 


int 


int 


struct  semid  ds 


int 


int 


int 


int 


int 


mt 


inter  to  struct  tm 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  type. 


/usr/include/svs/sem.h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  Libra 


Function 


MCC  SvstemError 


LookupProcessIdentifier 


Calls 


Where  Described 


Section  2.21.1.11.3. 


Section  2.21.1.26.2. 


Called  B 


Function 

Where  Described 

ReportIPCStatus 

Section  2.9  3.1.1. 

Table  2.9-32:  DisplaySemStatus  Information. 

2.9.3.1.4  DisplayMsgQStatus 

DisplayMsgQStatus  displays  the  YUMM  Message  queue  status.  The  function  call  is 
DisplayMsgQStatus(key).  Table  2.9-33  describes  the  parameters  used  and  functions  called 
using  this  function. 


Parameter 


ke 


Parameters 


e 


key  t 


Where  Tvoedef  Declared 


/usr/include/svs/tvpes.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

msqid 

int 

Standard  C  type. 

but 

struct  msqid  ds 

/usr/i  nclude/sy  s/msq .  h 

dime 


stime 


lastDent 


lastRcvd 


creator 


inter  to  struct  tm 


inter  to  struct  tm 


Standard  C  Libra 


Standard  C  Libra 


Standard  C  type. 


Standard  C  type. 


Standard  C  t 


Calls 

Function 

Where  Described 

MCC  SystemError 

Section  2.21.1.11.3. 

LookupProcessIdentifier 

Section  2.21.1.26.2. 
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1  Called  Bv  1 

Function 

Where  Described 

ReportIPCStatus 

Section  2.9.3.I.I. 

Table  2.9-33:  DisplayMsgQStatus  Information. 

2.9.4  Performance  Monitor  Command 

The  amount  of  shared  memory  used  by  several  internal  tables  may  be  monitored  using  this 
command.  This  is  accomplished  by  one  CSU,  perf.c. 


2.9.4. 1  perf.c 

/simnet/mcc/Terminal/perf.c 

perf.c  contains  a  function  which  reports  various  performance  and  memory  statistics. 

2.9.4. 1.1  ReportPerformance 

ReportPerformance  reports  on  the  number  of  packets  read  and  missed.  It  sends  out  a 
warning  if  too  many  packets  have  been  missed.  It  also  reports  the  size  of  the  Vehicle  List, 
Vehicle  Status  and  Activation  List  memories.  The  function  call  is 
ReportPerformance(cardMemory).  Table  2.9-34  describes  the  parameters  used  by  this 
function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

cardMemory 

pointer  to  Card  Memory  t 

/simnet/mcc/T  erminal/perf.c 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Missed 

lonq 

Standard  C  type. 

Pet 

float 

Standard  C  type. 

1  Called  By  1 

Function 

Where  Described 

cmd  perf 

Section  2,9. 1.2.6. 

Table  2.9-34;  ReportPerformance  Information. 


2.9.5  Process  Monitor  Command 

The  state  of  various  MCC  processes  may  be  displayed  using  this  command.  Each  process 
may  be  in  one  of  three  states: 


•  Unspawned, 

•  Alive  and  well,  or 

•  Dead. 


This  command  can  be  used  to  identify  processes  which  have  aborted  due  to  some  unknown 
or  unexpected  condition.  There  is  one  CSU,  process. c 
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2.9.5. 1  process.c 

/simnet/mcc/Terminal/process.c 

process.c  contains  a  function  to  determine  the  current  state  of  an  MCC  process.  Table 
2.9-35  describes  the  variables  used  by  process.c. 


1  Variables  1 

Variable 

Where  Tvpedef  Declared 

states 

pointer  to  array  3  of  char 

Standard  C  type. 

Table  2.9-35:  process.c  Variable  Information. 

2.9.5. 1.1  ProcessStatus 

ProcessStatus  determines  the  status  of  a  process.  The  function  call  is  ProcessStatus(). 
Table  2.9-36  describes  the  internal  variables  used  by  this  function. 


1  internal  Variables  I 

Variable 

Type 

Where  Tvpedef  Declared 

i 

int 

Standard  C  type. 

ProcessStatus 

int 

Standard  C  type. 

myPlD 

int 

Standard  C  type. 

Called  By 

Function 

Where  Described 

cmd  status  all 

Section  2.9.1.2.10. 

emd  status  process 

Section  2.9.1.2.14. 

Table  2.9-36:  ProcessStatus  Information. 


2.9.6  Status  Report  Command 

The  Status  Report  Command  handles  parsing  of  requested  status  information.  A  request 
for  status  of  ipc  facilities  or  MCC  processes  causes  a  dispatch  to  the  ipc  or  process  module 
respectively.  All  other  status  reports  are  handled  internally  in  this  module.  Currently, 
status  information  can  be  queried  about: 

•  Interprocess  Communication, 

•  Network  Adapter  Unit, 

•  MCC  Processes, 

•  Vehicle  Simulators  participating  in  an  exercise,  and 

•  YUMM  internals  (message  passing  facility). 

Vehicle  simulator  status  can  be  requested  by  trailer-trailer  element  bumper  number  or 
vehicle  ID  of  the  simulator  and  displays  information  such  as  simulator  status,  location,  and 
appearance. 

Network  Adapter  Unit  suiiisiics  call  the  network  interface  library  (libnetif)  to  display 
information  about  packets  received,  sent,  lost,  and  other  adapter  specific  capabilities  such 
as  carrier  loss,  collision  detection,  and  corrupted  packets.  Tliis  second  level  CSC  contains 
one  eSU,  status.c. 
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2.9.6.1  status.c 

/simnet/mcc/TerminaVstatus.c 

status.c  contains  routines  to  determine  the  status  of  various  MCC  processes.  It  is  called 
through  the  MCC  host’s  console  terminal.  Table  2.9-37  describes  the  variables  used  by 
status.c. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

Veh  Name  Map 

Name  Map 

/simnet/mcc/Terminal/status  .c 

Table  2.9-37:  status.c  Variable  Information. 

2.9.6. 1.1  SimStatusReport 

SimStatusReport  reports  on  the  status  of  a  specified  simulator,  sim.  The  function  call  is 
SimStatusReport(sim).  Table  2.9-38  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Sim 

pointer  to  SimulatorStatus 

/simnet/mcc/include/veh_tabl 

e.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

veh 

pointe  to  VehictelDStatus 

/simneVmcc/include/vehjabl 

e.h 

VAPDU 

pointer  to 

Vehicle  AppearanceVariant 

pro_sim.h 

location 

TDB_POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

sir 

array  20  of  char 

Standard  C  type. 

i 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

FQueue  Retrieve 

Section  2.21.1.13.7. 

xy  to  utm 

1  Called  By  1 

Function 

Where  Described 

VehicleStatusReport 

Section  2.9.6.I.2. 

cmd  status  all 

Section  2.9.1.2.10. 

cmd  status  bumper 

Section  2.9.1.2.11. 

cmd  status  sim 

Section  2.9.1.2.15. 

cmd  status  sims 

Section  2.9.1.2.16. 

Table  2.9-38:  SimStatusReport  Information. 
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2.9.6. 1.2  VehicleStatusReport 

VehicleStatusReport  reports  on  the  status  of  a  particular  vehicle  ID,  vehiclelD.  The 
function  call  is  VehicleStatusReport(vehiclelD).  Table  2.9-39  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

vehiclelD 

F>ointer  to  VehiclelD 

/simnet/common/include/prot 

ocol/basic.h 

internal  Variables 

Variable 

Where  Tvpedef  Declared 

veh 

register  pointer  to 
VehiclelDStatus 

/simnet/mcc/include/veh_tabl 

e.h 

VAPDU 

pointer  to 

VehicleAppearanceVariant 

/simnet/common/include/prot 
ocol/p  sim.h 

useStrinq 

pointer  to  array  of  char 

Standard  C  type. 

staleStrinq 

pointer  to  array  of  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

FQueue  Retrieve 

Section  2.21.1.13.7. 

SimStatusReport 

Section  2.9.6.I.I. 

cmd_  status  vid 

Section  2.9.1.2.17. 

Table  2.9-39:  VehicleStatusReport  Information. 


2.9.7  Simulator  Save/Restore 

The  Simulator  Save/Restore  commands  allow  the  operator  to  save  the  internal  MCC 
simulator  tables  to  a  disk  file  so  that  they  may  later  be  restored.  This  allows  an  MCC  to 
capture  the  state  of  all  of  its  manned  simulators  so  that  they  can  easily  be  restored  at  a  later 
time  from  this  "snapshot."  The  operator  may  save  and  restore  simulator  tables  by 
specifying  a  scenario  name.  Any  number  of  scenarios  may  be  stored  depending  only  on 
the  amount  of  disk  storage  space  available.  An  operator  may  choose  from  any  one  of  the 
previously  saved  scenarios  to  restore.  Upon  restoring  an  exercise,  all  simulators  are 
automatically  initialized  at  their  saved  position  and  status,  and  the  information  is  propagated 
to  all  of  the  appropriate  Macintosh  consoles.  There  is  one  CSU,  vehicle.c. 


2.9.7. 1  vehicle.c 

/simnet/mcc/Terminal/vehicle.c 

vehicle.c  contains  routines  for  reporting  the  status  of  vehicle  simulators.  Table  2.9-40 
describes  the  variable  used  by  vehicle.c. 


1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

tdb  errno 

extern  int 

Standard  C  type. 

Table  2.9-40:  vehicle.c  Variable  Information. 
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2. 9.7. 1.1  SimListSaves 


SimListSaves  lists  all  files  in  the  simulator  save  directory.  The  function  call  is 
SimListSaves(params).  Table  2.9-41  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

params 

pointer  to  char 

Standard  C  type. 

internal  Variables 

Variable 

Where  Tvpedef  Declared 

command 

array  500  of  char 

Standard  C  type. 

1  Called  Bv  1 

Function 

Where  Described 

cmd  list 

Section  2.9. 1.2.5. 

Table  2.9-41:  SimListSaves  Information. 


2.9.7. 1.2  SimSaveAll 


SimSaveAll  saves  the  simulator  states  into  a  specified  f\\t,file,  placed  in  the  saveDirectory. 
The  function  call  is  SimSaveAll(file).  Table  2.9-42  describes  the  parameters  used  and 
functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

file 

pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

saveFile 

array  MAXPATHLEN  of  char 

Standard  C  type. 

fd 

int 

Standard  C  type. 

i 

register  short 

Standard  C  type. 

Sim 

register  pointer  to 
SimulatorStatus 

/simnet/mcc/include/yehjabi 

e.h 

yeh 

pointer  to  VehiclelDStatus 

/simnet/mcc/inclujde/veh_tabl 

e.h 

astAppearance 

pointer  to 

VehicleAppearanceVariant 

pro_sim.h 

mbuf 

M  CC  M  essage  Buffer 

/simnet/mcc/include/MCC  ipc 
h 

msg 

pointer  to  MCCMessageBuffer 

/simnet/mcc/include/MCC  ipc 
.h 

rollPitchYaw 

array  3  of  float 

Standard  C  type. 

utmLocation 

array  2TDB  PREC+3ofchar 

Standard  C  type. 

location 

TDB  POINT 

/simnet/common/libsrc/libtdb/t 

db.h 

I  I 
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1  Calls  1 

Function 

Where  Described 

FQueue  Retrieve 

Section  2.21.1.13.7. 

DecodeHullToWorldMatrix 

Section  2.21.1.10.1. 

rad_to_mil 

Macro  defined  in 

/simnet/common/include/alobal//sim  macros. h. 

xy  to  utm 

cmd  save 

Section  2.9.1 .2.9. 

Table  2.9-42:  SimSaveAII  Information. 


2. 9.7. 1.3  SimRestoreAll 

SimRestoreAll  restores  simulators  from  a  specified  fWt,file.  The  function  call  is 
SimRestoreAll(file).  Table  2.9-43  describes  the  parameters  used  and  functions  called  using 
this  function. 


Parameter 


file 


Parameters 


inter  to  char 


Where  Tvoedef  Declared 


Standard  C  t 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

saveFile 

array  MAXPATHLEN  of  char 

Standard  C  type. 

fd 


buffer 


msg 


rsoKind 


errCode 


rsoLen 


utmLocation 


location 


array  MSG  SIZE  of  char 


pointer  to  MCCMessageBuffer 


pointer  to  SimulatorStatus 


int 


unsiqned  char 


array  2TDB  PREC+3ofchar 


TDB  POINT 


Standard  C  t 


Standard  C  type. 


/simnet/mcc/include/MCCJpc 

.h 


/simnet/mcc/include/vehjabi 

e.h 


Standard  C  type. 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


Standard  C  type. 


/simnet/common/libsrc/libtdb/t 

db.h 


Function 


xy  to  utm 


Transact 


SendMCCMsol 


Calls 


Where  Described 


Section  2.21.2.10.9. 


Macro  defined  in  /simnet/mcc/include/bridae.h. 


Function 


cmd  restore 


Called  B 


Where  Described 


Section  2.9. 1.2.8. 


Table  2.9-43:  SimRestoreAll  Information. 
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2.9.7.1.4  VehFromSimNum 

VehFromSimNum  looks  up  a  simulator  by  its  simulator  number,  given  by  str.  Valid 
simulator  numbers  consist  of  a  <numberxletter>  string  pair,  NOT  separated  by  any 
spaces.  VehFromSimNum  returns  a  pointer  to  the  SimulatorStatus  object  describing  the 
simulator,  or  0  if  none  is  found  with  that  number.  The  function  call  is 
VehFromSimNum(str).  Table  2.9-44  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared  1 

str 

pointer  to  char 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Sim 

pointer  to  SimulatorStatus 

/simnet/mcc/include/vehjabi 

e.h 

i 

register  short 

Standard  C  type. 

trailer 

int 

Standard  C  type. 

trailerElement 

char 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

pointer  to  SimulatorStatus 

No  Simulator  found  with  that 
numbe^ 

Sim 

pointer  to  SimulatorStatus 

Simulator  found. 

1  Called  By  1 

Function 

Where  Described 

cmd  status  sim 

Section  2.9.1.2.15. 

Table  2.9-44:  VehFromSimNum  Information. 

2. 9. 7. 1.5  VehFromBumper 

VehFromBumper  looks  up  a  simulator  by  its  bumper  number,  given  by  str.  Valid  bumper 
numbers  are  <company><bumper  #>  pairs  where  the  company  is  identified  by  the  letter  A, 
B,  C,  D,  F,  H,  L  or  S.  VehFromBumper  returns  a  pointer  to  the  SimulatorStatus  object 
describing  the  simulator,  or  0  if  none  is  found  with  that  number.  The  function  call  is 
VehFromBumper(str).  Table  2.9-45  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

str 

pointer  to  char 

Standard  C  type. 

internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Sim 

pointer  to  SimulatorStatus 

/simnet/mcc/include/vehjabi 

e.h 

i 

register  short 

Standard  C  type. 

bumper 

int 

Standard  C  type. 

char 

Standard  C  type. 
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1  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

pointer  to  SimulatorStatus 

No  simulator  found  with  that 
number. 

Sim 

pointer  to  SimulatorStatus 

Simulator  found. 

Called  Bv 

Function 

Where  Described 

veh  status  bumper 

Section  2.9.1.2.11. 

Table  2.9-45:  VehFromBuinper  Information. 

2.9.7.1.6  ValidSimNum 

ValidSimNum  determines  if  a  string,  cp,  is  a  valid  simulator  number,  i.e.  one  or  two  digits 
follewed  by  a  letter.  The  function  call  is  ValidSimNum(cp).  Table  2.9-46  describes  the 
parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

cp 

register  pointer  to  char 

Standard  C  type. 

1  Return  Values  I 

Return  Value 

Meaning 

0 

int 

Sim  number  not  valid. 

1 

int 

Sim  number  valid. 

Table  2.9-46:  ValidSimNum  Information. 

2.9.7. 1.7  ValidBumperNumber 

ValidBumperNumber  determines  if  a  string,  cp,  is  a  valid  bumper  number,  i.e.  a  letter 
followed  by  one  or  two  digits.  The  function  call  is  ValidBumperNumber(cp).  Table 
2.9-47  describes  the  parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

cp 

register  pointer  to  char 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

Bumper  number  not  valid. 

1 

int 

Bumper  number  valid. 

Table  2.9-47:  ValidBumperNumber  Information. 
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2.10  Masscomp  Communication  Software 

This  CSC  allows  communication  between  the  process  on  the  Masscomp®  5600  and  the 
Bridge  console.  The  ATSend  and  ATRecv  processes  correctly  the  appropriate  encoding  and 
decoding  of  messages  that  are  sent  over  the  RS-232  cable  connecting  the  two  computers. 
The  structure  of  the  CSC  is  shown  in  Figure  2.10-1. 


Masscomp  Communications  Software 

1.10 

ATSend 

Process 

ATRecv 

Process 

1.10.1 

1.10.2 

—  send.c 

—  recv.c 

1.10.1.1  1.10.2.1 


Figure  2.10*1:  Masscomp  Communication  Software  Structure. 

The  CSC  has  two  second  level  CSCs  associated  with  it: 

ATSend  Process 
\TRecv  Process 


2.10.1  ATSend  Process 

The  MCC  AppleTalk  Send  Process  is  responsible  for  sending  messages  from  the  MCC 
host  system  to  one  or  more  Apple  Macintosh  consoles.  The  ATSend  process  receives 
messages  from  MCC  host  processes  and  performs  the  necessary  encapsulation  required  by 
the  AppleTalk  Bridge.  The  encapsulated  messages  are  transmitted  across  a  low  speed 
(9600  baud)  serial  line  to  an  AppleTalk  Bridge.  The  Bridge  acts  as  a  physical  layer  router 
between  the  AppleTalk  Network  and  the  serial  line  connected  to  the  MCC  host  system. 

The  encapsulation  performed  includes: 

•  Assembling  a  short  header  which  specifies  the  originator  of  the  message, 

•  Prefixing  a  header  for  packet  framing  information,  and 

•  Adding  a  checksum  to  the  packet. 
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An  interframe  gap  of  100  milliseconds  allows  the  AppleTalk  Bridge  enough  time  to  process 
and  transmit  the  packet  onto  the  AppleTalk  network,  obviating  the  need  for  more  complex 
flow  control  between  the  MCC  host  and  Bridge  system.  One  CSU  realizes  this 
fu  i^Lionality,  send.c. 


2.10.1.1  send.c 

/simnet/mcc/ATSend/send.c 

send.c  contains  routines  which  implement  the  AppleTalk  network  send  process.  Table 
2.10-1  describes  the  variables  used  by  send.c. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

fd 

int 

Standard  C  type. 

hexDiqit 

array  of  char 

Standard  C  type. 

Table  2.10-1:  send.c  Variable  Information. 

2.10.1.1.1  main 

main  is  the  entry  point  to  the  ATSend  process.  The  function  call  is  main(argc,  argv). 
Table  2.10-2  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

arqc 

int 

Standard  C  type. 

arqv 

pointer  to  pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

tio 

struct  termio 

/usr/include/termio .  h 

Calls 

Function 

Where  Described 

InitializesProcess 

Section  2.21.1.19.1. 

MCC  SystemError 

Section  2.21.1.11.3. 

Unlock 

Section  2.21.2.6.4. 

Table  2.10-2:  main  Information. 

2.10.1.1.2  ProcessMessage 

ProcessMessage  handles  a  message  requesting  a  DDP  packet  to  be  sent,  type  indicates 
whether  the  message  is  a  one-way,  asynchronous  or  sychronous  request,  or  a  response  to  a 
previous  request,  kind  indicates  the  type  of  message  which  has  been  received,  length 
indicates  the  length  of  the  data  in  the  message  received,  data  is  a  pointer  to  the  actual 
message  data.  Information  is  extracted  from  the  message  data  based  on  the  kind  of 
message.  The  function  call  is  ProcessMessageftype,  kind,  length,  data).  Table  2.10-3 
describees  the  parameters  used  and  functions  call^  using  this  function. 
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1  Parameters  I 

1  Parameter 

Where  Tvpedef  Declared 

int 

Standard  C  type. 

kind 

long 

Standard  C  type. 

length 

int 

Standard  C  type. 

data 

register  pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

len 

int 

Standard  C  type. 

i 

register  int 

Standard  C  type. 

cp 

register  pointer  to  char 

Standard  C  type. 

bp 

register  pointer  to  char 

Standard  C  type. 

but 

array  of  bridgeFrameSize  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

PutBvte 

Macro  defined  in  /simnet/mcc/ATSend/send.c. 

MCC  SystemError 

Section  2.21.1.11.3. 

Table  2.10*3:  ProcessMessage  Information. 


2.10.2  ATRecv  Process 

The  AppleTalk(tni)  Receive  Process  is  responsible  for  processing  AppleTalk  Network 
packets  passed  to  the  MCC  host  over  a  serial  line  connection.  Typically,  an  Apple 
Macintosh  computer  is  used  as  a  physical  layer  router  between  the  AppleTalk  Network  and 
the  serial  line  used  by  the  MCC  host  system  to  communicate  with  the  MCC  Macintosh 
consoles. 

ATRecv  reads  in  each  packet  passed  over  the  serial  line,  performs  error  checksumming, 
decodes  the  message  type  in  the  packet,  and  dispatches  the  message  to  the  specified 
recipient.  There  is  one  CSU,  recv.c. 


2.10.2.1  recv.c 

/simnet/mcc/ATRecv/recv.c 

recv.c  contains  routines  which  implement  the  AppleTalk  network  receive  process. 

2.10.1.2.1  main 

main  is  the  entry  point  to  the  ATRecv  process.  The  function  call  is  main(argc,  argv). 
Table  2.10-4  describes  the  parameters  used,  errors  returned  and  functions  called  using  this 
function. 


1  Parameters  I 

1  Parameter 

Where  Tvpedef  Declared 

int 

Standard  C  type. 

largv 

pointer  to  pointer  to  char 

Standard  C  type. 

1 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

fd 

int 

Standard  C  type. 

len 

int 

Standard  C  type. 

fmLen 

int 

Standard  C  type. 

fmChk 

int 

Standard  C  type. 

fmSrc 

int 

Standard  C  type. 

fmDst 

int 

Standard  C  type. 

i 

register  int 

Standard  C  type. 

CD 

register  pointer  to  char 

Standard  C  type. 

bp 

register  pointer  to  char 

Standard  C  type. 

tio 

struct  termio 

/usr/include/termio.h 

client 

YUMMSocket 

/si  mnet/rcs/libi  pc/y  umm .  h 

msg 

MCCMessageBuffer 

/simnet/mcc/inciude/MCC  ipc 
.h 

but 

array  bridgeFrameSize  of  char 

Standard  C  type. 

1  Errors  1 

Error  Name 

Reason  for  Error 

MCC  BAD  FRAME 

Bad  frame  received  from  bridge. 

MCC  DDP  OVERRUN 

No  buffer  for  incoming  DDP  datagram. 

1  Calls  1 

Function 

Where  Described 

InitializeProcess 

Section  2.21.1.19.1. 

MCC  SvstemError 

Section  2.21.1.11.3. 

GetByte 

Macro  defined  in  /simnet/mcc/ATRecv/recv.c. 

ATAIIocBuffer 

Section  2.21.1.2.1. 

ATFreeBuffer 

Section  2.21.1.2.2. 

|ri  hi  Mil  1 

Section  2.21.2.10.6. 

Table  2.10-4:  main  Information. 
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2.11  The  Bridge  Console 

The  Bridge  Console  is  a  Macintosh  application  that  relays  information  between  an 
AppleTaUc  network  and  an  RS-232  serial  line.  This  relay  operates  above  the  link  layer. 
AppleTalk  LAP  frames  are  received  by  Bridge  and  retransmitted  on  the  serial  line  in 
encoded  form.  Encoded  frames  are  received  on  the  serial  line  and  retransmitted  as 
AppleTalk  LAP  frames. 


Figure  2.11-1:  Bridge  Console  Structure. 
2.11.1  Bridge  Program 


2.11.1.1  HexDigit 

HexDigit  converts  i  to  hexidecimal  digits.  The  function  call  is 
HexDigit(i:INTEGER):INTEGER.  Table  2.1 1-1  describes  the  parameters  used  by  this 
function. 


Parameters 


Parameter 


Variable 


Function 


EncodeFrame 


ValidFrame 


Send  Answer 


Where  Type  Declared 


Standard  Pascal  Type. 


Internal  Variables 


INTEGER 


Called  B 


Where  Described 


Section  2.11.1.6. 


Section  2.11.1.7. 


Section  2.11.1.10. 


Where  Type  Declared 


Standard  Pascal  Type. 


Table  2.11-1:  HexDigit  Information. 
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2.11.1.2  BinNibble 

BinNibble  nibbles  /  into  4  byte  binary  chunks.  TTie  function  call  is 
BinNibble(i:INTEGER):INTEGER.  Table  2.11-2  describes  the  parameters  used  by  this 
function. 


1  Parameters  | 

Parameter 

Where  Type  Declared  I 

i 

INTEGER 

1  Called  By  1 

Function 

Where  Described 

ValidFrame 

Section  2.11.1.7. 

DecodeFrame 

Section  2.11.1.8. 

Table  2.11-2:  BinNibble  Information. 

2.11.1.3  Queue  ARead 

QueueARead  reads  a  packet  off  the  Appletalk  and  adds  it  to  the  read  queue.  The  procedure 
call  is  QueueARead(i: INTEGER).  Table  2.1 1-3  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  procedure. 


1  Parameters  | 

Parameter 

Type 

Where  Type  Declared 

i 

INTEGER 

Standard  Pascal  Type. 

Internal  Variables 

Variable 

Type 

Where  Type  Declared  1 

errCode 

INTEGER 

1  Errors  1 

Error  Name 

Reason  for  Error 

Error  while  trying  to  queue  an 
AppleTalk  read. 

Call  to  LAPRead  failed. 

1  Calls  1 

Function 

Where  Described 

LAPRead 

Standard  Appletalk  Manager  function  for  Macintosh. 

1  Called  By  1 

Function 

Where  Described 

ChkSerOut 

Section  2.11.1.15. 

Setup 

Section  2.11.1.16. 

Bridge 

Section  2.11.1.17. 

Table  2.11-3:  QueueARead  Information. 
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2.11.1.4  QueueAWrite 


QueueAWrite  writes  a  packet  to  the  Appletalk  network  from  the  write  queue.  The  procedure 
call  is  QueueAWrite(i:INTEGER).  Table  2.1 1-4  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  procedure. 


Parameters 


Parameter 


IDT:! 


e 


Where  Type  Declared 


Variable 


errCode 


Internal  Variables 


e 


INTEGER 


11273 


Where  Type  Declared 


Standard  Pascal  Type. 


Error  Name 


Error  while  tryig  to  queue  an 
AppleTalk  write. 


Errors 


Reason  for  Error 


Call  to  LAPWnte  failed. 


Function 


LAPWrite 


Calls 


Where  Described 


letalk  Manaqer  function  for  Macintosh. 


Called  B 


Function 

Where  Described 

EndOfFrame 

Section  2.11.1.13. 

Table  2.11>4:  QueueAWrite  Information. 

2.11.1.5  QueueSWrite 

QueueSWrite  writes  a  packet  from  the  queue  to  the  serial  line  connected  to  the  MCC  host. 
The  procedure  call  is  QueueSWrite(i:INTEGER).  Table  2.1 1-5  describes  the  parameters 
used,  errors  returned  and  functions  called  using  this  procedure. 


Parameters 


Parameter 


e 


Where  Type  Declared 


Variable 


errCode 


Internal  Variables 


e 


INTEGER 


Where  Type  Declared 


Error  Name 


Error  while  trying  to  queue  a 
serial  write. 


Errors 


Reason  for  Error 


Call  to  PBWrite  failed. 


Function 


PBWrite 


Calls 


Where  Described 


Standard  Device  Manaqer  function  for  Macintosh. 
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Called  B 


Function 

Where  Described 

Bridqe 

Section  2.11.1.17. 

Table  2.11*5:  QueueSWrite  Information. 

2.11.1.6  EncodeFrame 

EncodeFrame  Ells  in  fields  of  a  packet  according  to  standard  Appletalk  format.  The 
procedure  call  is  EncodeFrame(i:INTEGER).  Table  2.1 1-6  describes  the  parameters  used 
and  functions  called  using  this  procedure. 


Parameters 


Parameter 


\wm 


e 


Where  Tvoe  Declared 


Variable 


len 


Internal  Variables 


e 


INTEGER 


INTEGER 


INTEGER 


INTEGER 


Where  Tvoe  Declared 


Standard  Pascal  Type. 


Standard  Pascal  Type. 


Function 


HexDiait 


Calls 


Where  Described 


Section  2.11.1.1. 


Called  B 


Function 

Where  Described 

Bridqe 

Section  2.11.1.17. 

Table  2.11-6:  EncodeFrame  Information. 

2.11.1.7  ValidFrame 

ValidFrame  checks  a  packet  to  see  if  its  checksum  matches  its  date.  The  function  call  is 
ValidFrame(i:INTEGER):BOOLEAN.  Table  2.1 1-7  describes  the  parameters  used  and 
functions  called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

BinNibble 

Section  2.11.1.2. 

HexDiqit 

Section  2.11.1.1. 

Called  By 

Function 

Where  Described 

EndOfFrame 

Section  2.11.1.13. 

Table  2.11-7:  ValidFrame  Information. 


2.11.1.8  DecodeFrame 

DecodeFrame  takes  a  packet  sent  from  the  host  and  adds  information  to  make  it  an 
Appletalk  packet  to  send  to  one  of  the  consoles.  The  procedure  call  is 
DecodeFrame(i:INTEGER).  Table  2.1 1-8  describes  the  parameters  used,  errors  returned 
and  functions  called  using  this  procedure. 


1  Parameters  I 

Parameter 

Type 

Where  Type  Declared 

V 

INTEGER 

Standard  Pascal  Type. 

Internal  Variables 

Variable 

Type 

Where  Type  Declared  1 

len 

INTEGER 

i 

INTEGER 

Standard  Pascal  Type .  1 

k 

INTEGER 

ch 

INTEGER 

Standard  Pascal  Type.  I 

1  Calls  1 

Function 

Where  Described 

BinNibble 

Section  2.11.1.2. 

1  Called  By  1 

Function 

Where  Described 

EndOfFrame 

Section  2.11.1.13. 

Table  2.11-8; 


DecodeFrame  Information. 
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2.11.1.9  QueryFrame 

QueryFrame  determines  if  this  frame  is  a  query  frame  which  is  asking  for  the  address  of  the 
bridge.  The  function  call  is  QueryFrame(i:INTEGER):BOOLEAN.  Table  2.1 1-9 
describes  the  parameters  used  by  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Type  Declared  I 

i 

INTEGER 

1  Called  By  I 

Function 

Where  Described 

EndOfFrame 

Section  2.11.1.13. 

Table  2.11-9:  QueryFrame  Information. 

2.11.1.10  SendAnswer 

SendAnswer  sends  the  node  and  net  address  of  the  bridge  back  to  the  requester.  The 
procedure  call  is  SendAnswer.  Table  2.1 1-10  describes  the  internal  variables  used,  errors 
returned  and  functions  called  using  this  procedure. 


1  Internal  Variables  1 

Variable 

Type 

Where  Type  Declared 

errcode 

INTEGER 

Standard  Pascal  Type. 

myNode 

INTEGER 

Standard  Pascal  Type. 

myNet 

INTEGER 

Standard  Pascal  Type. 

ten 

Lonqint 

but 

PACKED  ARRAY  (1... 7]  OF 
Byte 

1  Errors  I 

Error  Name 

Reason  for  Error 

Error  in  obtaining  node 
address. 

Call  to  GetNodeAddress  failed. 

Call  to  FSWrite  failed. 

1  Calls  1 

Function 

Where  Described 

GetNodeAddress 

Standard  Aooletalk  Manaqer  function  for  Macintosh. 

HexDiqit 

Section  2.11.1.1. 

FSWrite 

Standard  Device  Manager  function  for  Macintosh. 

1  Called  By  1 

Function 

Where  Described 

EndOtFrame 

Section  2.11.1.13. 

Table  2.11-10:  SendAnswer  Information. 
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2.11.1.11  StartOfFrame 


StartOfFrame  finds  a  buffer  available  to  store  the  new  packet  from  the  serial  line.  The 
procedure  call  is  StartOfFrame.  Table  2.1 1-1 1  describes  the  internal  variables  used  by  this 
procedure. 


Variable 


internal  Variables 


e 


INTEGER 


IfSTIX 


Where  Tvoe  Declared 


Called  B 


Function 

Where  Described 

ChkSerIn 

Section  2.11.1.14. 

Table  2.11*11:  StartOfFrame  Information. 

2.11.1.12  AppendByte 

AppendByte  appends  the  inputted  character  to  the  end  of  the  current  buffer.  The  procedure 
call  is  AppendByte(ch:INTEGER).  Table  2.11-12  describes  the  parameters  used  by  this 
procedure. 


Parameters 


Parameter 


ch 


Variable 


e 


INTEGER 


Internal  Variables 


e 


INTEGER 


lEiT! 


Where  Tvoe  Declared 


Standard  Pascal  Tvoe. 


Where  Tvoe  Declared 


Called  B 


Function 

Where  Described 

ChkSerIn 

Section  2.11.1.14. 

Table  2.11*12:  AppendByte  Information. 

2.11.1.13  EndOfFrame 

EndOfFrame  checks  if  frame  is  valid  and  if  it  is,  queues  it  to  be  written  to  the  Appletalk  net. 
If  current  frame  is  a  query  frame,  sends  node  and  net  address.  The  procedure  call  is 
EndOfFrame.  Table  2.1 1-13  describes  the  errors  returned  and  functions  called  using  this 
procedure. 
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1  Calls  1 

Function 

Where  Described 

QuervFrame 

Section  2.11.1.9. 

SendAnswer 

Section  2.11.1.10. 

ValidFrame 

Section  2.11.1.7. 

Decode  Frame 

Section  2.11.1.8. 

QueueAWrite 

Section  2.11.1.4. 

Called  By 

Function 

Where  Described 

ChkSerIn 

Section  2.11.1.14. 

Table  2.11-13:  EndOfFrame  Information. 

2.11.1.14  ChkSerIn 

ChkSerIn  checks  to  see  if  any  characters  have  arrived  on  the  serial  line  and  loads  them  into 
a  local  buffer.  The  procedure  call  is  ChkSerIn.  Table  2.1 1-14  describes  the  internal 
variables  used,  errors  returned  and  functions  called  using  this  procedure. 


I  Internal  Variables  I 

Variable 

Type 

Where  Type  Declared 

errCode 

INTEGER 

Standard  Pascal  Type. 

i 

INTEGER 

Standard  Pascal  Type. 

ch 

INTEGER 

Standard  Pascal  Type. 

arrived 

Lonqint 

str 

PACKED  ARRAY  [1..  100]  OF 
Byte 

Errors 

Error  Name 

Reason  for  Error 

SerGetBuf  failed. 

Cali  to  SerGetBuf  failed. 

FSRead  on  serial  port  failed. 

Call  to  FSRead  failed. 

Calls 

Function 

Where  Described 

SerGetBuf 

Standard  Serial  Drivers  function  for  Macintosh. 

FSRead 

Standard  Device  Manager  function  for  Macintosh. 

EndOfFrame 

Section  2.11.1.13. 

AppendByte 

Section  2.11.1.12. 

StartOfFrame 

Section  2.11.1.11. 

Called  By 

Function 

Where  Described 

Bridge 

Section  2.11.1.17. 

Table  2.11-14:  ChkSerIn  Information. 
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2.11.1.15  ChkSerOut 

ChkSerOut  looks  for  completed  serial  transmissions.  The  procedure  call  is  ChkSerOut. 
Table  2.1 1-15  describes  the  internal  variables  used,  errors  returned  and  functions  called 
using  this  procedure. 


Variable 


Internal  Variables 


e 


INTEGER 


I  on 


Where  Type  Declared 

Standard  Pascal  Type- 


Error  Name 

Serial  write  failed. 


_ Errors 

Reason  for  Error 


Calls 

Function 

Where  Described 

QueueARead 

Section  2.11.1.3. 

Called  B 


Function 

Where  Described 

Bridqe 

Section  2.11.1.17. 

Table  2.11-15:  ChkSerOut  Information. 


2.11.1.16  Setup 

SetUp  initializes  the  environment  for  the  bridge  Mac.  It  initializes  the  Mac  application 
environment,  the  queue  data  structure,  the  Appletalk  driver,  and  the  serial  dnver.  The 
procedure  call  is  SetUp.  Table  2.1 1-16  describes  the  internal  variables  used,  errors 
returned  and  functions  called  using  this  procedure. 


Variable 


tRect 


errCode 


Internal  Variables 


e 


Where  Tvoe  Declared 


INTEGER 

Standard  Pascal  Type. 

INTEGER 

Standard  Pascal  Type. 

Error  Name 


Error  in  openina  AppleTalk. 


Error  in  disablino  DDP. 


Error  in  opening  default 
protocol  handler. 


Error  in  opening  serial  output 
driver. 


Error  in  resetting  serial  output 
driver. 


Error  in  opening  serial  input 
driver. 


Error  in  resetting  serial  input 
driver. 


Errors 


Reason  for  Error 


Call  to  MPPOpen  failed. 


Call  to  LA PCIose Protocol  failed. 


Call  to  LAPOpenProtocol  failed. 


Call  to  OpenDriver  failed. 


Call  to  SerReset  failed. 


Call  to  OpenDriver  failed. 


Call  to  SerReset  failed. 
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1  Calls  1 

Function 

Where  Described 

WWInit 

Standard 

InitGraf 

Standard  Quickdraw  function  for  Macintosh. 

InitFonls 

Standard  Font  Manager  function  for  Macintosh. 

Flush  Events 

Standard  Operating  System  Events  Manager  function  for 
Macintosh. 

InitWindows 

Standard  Window  Manager  function  for  Macintosh. 

InitCursor 

Standard  Quickdraw  function  for  Macintosh. 

SetRect 

Standard  Quickdraw  function  for  Macintosh. 

WWNew 

Standard 

BufStrPtr 

Standard 

NewRr 

Standard  Memory  Manager  function  for  Macintosh. 

ABRecHandle 

Standard  Appletalk  Manager  function  for  Macintosh. 

NewHandle 

Standard  Memory  Manager  function  for  Macintosh. 

HLock 

Standard  Memory  Manager  function  for  Macintosh. 

Handle 

Standard  Memory  Manager  function  for  Macintosh. 

Rr 

Standard  Memory  Manager  function  for  Macintosh. 

ParmBIkRr 

Standard  Device  Manager  function  for  Macintosh. 

MPPOpen 

Standard  Appletalk  Manager  function  for  Macintosh. 

LAPCIoseProtocol 

Standard  Appletalk  Manager  function  for  Macintosh. 

LAPOpenProtocol 

Standard  Appletalk  Manager  function  for  Macintosh. 

OpenDriver 

Standard  Device  Manager  function  for  Macintosh. 

SerReset 

Standard  Serial  Drivers  function  for  Macintosh. 

QueueARead 

Section  2.11.1.3. 

Called  By 

Function 

Where  Described 

Bridge 

Section  2.11.1.17. 

Table  2.11-16:  SetUp  Information. 


2.11.1.17  Bridge 

Bridge  is  the  main  program  of  the  Bridge  Console.  This  program  first  calls  SetUp  in  order 
to  initialize  the  operating  environment.  Bridge  then  processes  events.  Information  is 
relayed  between  the  AppleTalk  network  and  the  RS-232  serial  line.  The  program  call  is 
Bridge.  Table  2.1 1-17  describes  the  internal  variables  used,  errors  returned  and  functions 
called  using  this  program. 
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Variable 


myEvent 


code 


whichWindow 


aRecvCount 


aXmitCount 


sRecvCount 


sXmitCount 


buffers 


serialOut 


senalln 


availBuf 


traceMode 


Internal  Variables 


e 


EventRecord 


BOOLEAN 


INTEGER 


WindowRr 


INTEGER 


INTEGER 


INTEGER 


INTEGER 


ARRAY  [1  ..numberBuffers]  of 
Buffer 


INTEGER 


INTEGER 


INTEGER 


INTEGER 


BOOLEAN 


Where  Tvoe  Declared 


e. 


Standard  Pascal  T 


Standard  Pascal  T 


e. 


Type  defined  in  Bndge. 


Standard  Pascal  T 


Error  Name 


AppleTalk  read  failed. 


AppleTalk  write  failed. 


Errors 


Reason  for  Error 


Function 


SelU 


SystemTask 


GetNextEvent 


Find  Window 


WWMouseDown 


WindowPtr 


WWActivate 


WWUodateEvent 


ABRecHandle 


EncodeFrame 


OueueSWrite 


QueueARead 


ChkSerIn 


ChkSerOut 


Calls 


Where  Described 


Section  2.11.1.16. 


Standard  Desk  Manaoer  function  for  Macintosh. 


Standard  Toolbox  Event  Manaoer  function  for  Macintosh. 


Standard  Window  Manaoer  function  for  Macintosh. 


Standard 


Standard  Window  Manaoer  function  for  Macintosh. 


Standard 


Standard 


letalk  Manaoer  function  for  Macintosh. 


Section  2.11.1.6. 


Section  2.11.1.5. 


Section  2.11.1.3. 


Section  2.11.1.14. 


Section  2.11.1.15. 


Table  2.11-17:  Bridge  Information. 
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2.12  Appletalk  Network  Software 
Overview  of  the  Network 

The  Management,  Command,  and  Control  System  (MCC)  uses  the  AppleTalk  network  to 
link  all  Macintosh  computers  with  each  other  and  to  the  MCC  host  system  via  a  bridge  link 
on  the  network  to  the  host .  AppleTalk  is  a  proprietary  network  protocol  developed  and 
supported  by  Apple  Computer  Corporation  to  provide  a  vehicle  for  sharing  information  and 
transferring  information  from  one  Apple  system  to  another  in  the  network.  This  network 
protocol  has  been  tied  to  the  MCC  host  system  via  a  programmed  link  on  a  Macintosh 
system  which  allows  it  to  become  the  bridge  from  the  AppleTalk  network  to  the  host 
system.  In  fact,  it  is  called  the  Bridge  Macintosh  from  Appletalk  to  the  MCC  host. 

Appletalk  Network  Format 

The  AppleTalk  network  developed  by  Apple  Ckmiputer  involves  not  only  a  physical  link  for 
carrying  data,  but  also  a  family  of  protocols  for  use  over  that  link.  These  protocols  are 
organist  into  a  hierarchy  of  layers  similar  to  that  of  the  International  Standardds 
Organization’s  GSO)  Open  System  Interconnection  (OSI)  basic  reference  model.  Each 
protocol  layer  in  the  hierarchy  provides  services  that  are  used,  in  turn,  by  the  next  higher 
layer  to  provide  services  that  are  more  complex  or  specialized.  The  lower  layers  provide  a 
means  to  group  data  into  packets,  addressing  data  packets  to  specific  computers  (nodes)  on 
the  network.  The  intermediate  layers  build  on  the  lower  layers  to  provide  reliable  data 
transfer,  and  provide  a  means  for  locating  nodes  on  the  network  by  name.  The  highest 
layers  contain  protocols  for  specific  applications,  such  as  controlling  printers  or  accessing 
file  servers. 

Network  Protocols 

Within  each  computer  (node)  there  are  one  or  more  logical  entities,  known  as  sockets. 
Nodes,  and  sockets  within  a  node,  are  addressable  from  other  nodes  in  the  network  by 
their  unique  name. 

The  MCC  System  directly  uses  the  services  of  two  AppleTalk  protocols,  called  the  Name 
Binding  Protocol  (NBP)  and  the  AppleTalk  Transaction  Protocol  (ATP^  These  protocols, 
in  turn,  use  lower  layer  protocols  called  the  Datagram  Delivery  Protocol  (DDP),  and  the 
AppleTalk  Link  Access  Protocol  (ALAP).  These  four  layers  together  with  the  AppleTalk 
cable  provide  the  physical  layer,  data  link  layer,  network  layer,  and  transport  layer  for  the 
network. 

MCC/Macintosh  to  Host  Implementation 

The  MCC  host  participates  in  the  AppleTalk  network  through  a  Macintosh  computer 
programmed  to  become  the  Bridge  to  the  host.  An  RS-232  line  runs  between  the  host  and 
the  Bridge.  The  Macintosh  application  computers  are  tied  to  the  Bridge  Macintosh  via  an 
AppleTalk  twisted  pair  shield^  cable.  Signalling  on  the  cable  is  at  230.4  Kbaud,  using 
standard  RS-422  drivers  and  receivers. 
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A  Macintosh  application  that  is  expecting  to  receive  ATP  requests  sets  up  buffers  that  will 
be  used  to  contain  those  those  requestes  when  they  arrive.  The  application  is  notified  when 
a  request  arrive  by  an  event  it  encounters  in  its  main  event  program  loop.  Similarly,  an 
application  that  is  expecting  to  receive  a  response  to  a  request  it  is  issuing  will  supply  a 
buffer  to  contain  that  response.  An  event  wil  signal  the  arrival  of  the  response.  All  of  the 
consoles  (the  application  Macintoshes)  make  use  of  this  feature,  which  ^ows  them  to 
engage  the  MCC  host  in  ATP  transactions  while  carrying  on  with  oth  er  processing 
requirements. 

The  MCC  host  participates  in  the  Appletalk  networic  through  the  Bridge  by  host  processes 
called  ATSend  and  ATRecv.  There  is  a  shared  memory  area  on  the  network  called  the 
AppleTalk  Info  shared  memory  area  on  the  host,  and  a  library  of  routines  incoiporated  into 
each  host  console  process.  This  shared  memory  area  worics  through  the  ATRecv  and 
ATSend  processes  and  the  host  message  system  to  send  and  receive  messages  from  the 
host  to  the  Bridge  through  to  the  AppleTalk  network  and  back. 
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2.13  The  see  eonsole 


see  Console 
1.13 


Simulating 

Command 

Post 

Vehicles 

1.13.1 


adminlog.c 

1.13.1.1 

t—  toc.c 

1.13.1.2 


Allocation, 

Placement 

and 

Reconsti¬ 
tution  of 
Vehicle 
Simulators 
1.13.2 


I—  alloc.c 

1.13.2.1 

1—  place. c 

1.13.2.2 


Simulation! 
of  Combati 
Service 
Support 
1.13.3 


css.c 

'1.13.3.3 

depots.c 

'1.13.3.4 


Simulation 
of  Close 
Air 

and  Fre 
Support 
1.13.4 


I— cas-c 

1.13.4.1 

L— fse.c 

1.13.4.2 


truckentry.c 

‘1.13.3.7 

trucktable.c 

‘1.13.3.8 


Reconsti¬ 
tution  of 
Simulated 
Vehicles 
1.13.5 


{.ceconscr.h 

1.13.5.1 

-reconscr.c 

1.13.5.2 

-reconst.c 

1.13.5.3 


Simulating 

Gunnery 

Targets 

1.13.6 


I _ target.h 

1.13.6.1 


I — target.c 

1.13.6.2 

I — tgtentry.c 

1.13.6.3 

I — Igttable.c 

1.13.6.4 


Visual 
Appearanc^ 
of  see  Usej 
Interface 
1.13.7 


|_SCC 
Pictures 
1.13.7.1 


-resource.h 

1.13.7.2 


Auxiliary 

Software 

1.13.8 


USCC.h 

1.13.8.1 

t  — Sv^CMac.h 

1.13.8.2 

|--SCeitincludes.c 

1.13.8.3 

l—SCCoptions.h 

1.13.8.4 

-version. h 

1.13.8.5 

-atalk.c 

1.13.8.6 

I— data. c 

1.13.8.7 

.dialog.c 

1.13.8.8 

-displace. h 

1.13.8.9 

■displace. c 

1.13.8.10 

I— exercise.c 

1.13.8.11 

-file.c 

1.13.8.12 

Jnit.c 

1.13.8.13 

I— lock.c 

1.13.8.14 

I— main.c 

1.13.8.15 

)_master.c 

1.13.8.16 

|— setup.c 

1.13.8.17 

I _ string.c 


Figure  2.13-1:  SCC  Console  Structure. 


260 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.13.1  Simulating  Command  Post  Vehicles 


2.13.1.1  adminlog.c 

Development:SIMNET:MCC:SCC:adniinlog.c 

adminlog.c  contains  routines  for  positioning  and  reconstituting  the  simulated  Admin/Log 
Center  vehicle.  Table  2.13-1  describes  the  variables  used  by  adminlog.c. 


1  variables  1 

Variable 

Tvoe 

Where  Tvoedef  Declared 

alocRole 

char 

Standard  C  type. 

alocLocation 

MapCoordinates 

DevelopmentiSIMNET  ilibmac; 
map.h 

alocCancelField 

PushButtonFieldDefn 

Development:SIMNET  ilibmac: 
dialoQ.h 

alocRBFields 

array  of  RBFieldDefn 

DevetopmentiSIMNET  ;libmac; 
dialog. h 

alocLocationField 

CoordinatesFieldDefn 

DevelopmentiSIMNET  ilibmac; 
dialOQ.h 

alocFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoQ.h 

initALOCDialog 

OialogNodeDefn 

DevebpmentiSIMNET  ilibmac; 
seouence.h 

reconstALOCDialog 

DialogNodeDefn 

DevelopmentiSIMNET  ilibmac; 
seouence.h 

Table  2.13*1:  adminlog.c  Variable  Information. 
2.13.1.1.1  LoadCannedALOC 


LoadCannedALOC  loads  canned  Admin/Log  center  initialization  data.  The  function  call  is 
LoadCannedALOC().  Table  2.13-2  describes  the  function  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

StrinqToMapCoordinates 

See  Section  2.22.1.26.1. 

Called  By 

Function 

Where  Described 

LoadCannedData 

See  Section  2.13.8.15.2. 

Table  2.13*2:  LoadCannedALOC  Information. 

2.13.1.1.2  UploadALOCParameters 

UploadALOCParameters  uploads  information  to  the  host  about  Admin/Log  Center 
parameters.  This  function  will  only  do  something  if  VERSION  is  APPLETALK. 
Otherwise,  it  is  just  a  dummy  function.The  function  call  is  UploadALOCParameters(). 
Table  2.13-3  describes  the  internal  variable  used  and  functions  called  using  this  function. 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

req 

SCOALOCRdQUGSt 

Development:SIMNET  :MCC: 
SCC:SCC.h 

Calls 

Function 

Where  Described 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

ATPPut 

See  Section  2.22.1.3.3. 

Called  Bv 

Function 

Where  Described 

ALOCEvent 

See  Section  2.13.1.1.5. 

Table  2.13-3:  Upload ALOCParameters  Information. 
2.13.1.1.3  ALOCInitFetch 

ALOCInitFetch  labels  the  radio  buttons  that  display  the  choice  of  forces  in  the  AdminA-og 
Center  Init  dialog.  The  function  call  is  ALC)ClnitFetch(state).  Table  2.13-4  describes  the 
parameter  used  and  function  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  DialogState 

Development:SIMNET  :libmac; 
dialog. h 

Calls 

Function 

Where  Described 

LabelForceButtons 

See  Section  2.22.1.16.1. 

Table  2.13-4:  ALOCInitFetch  Information. 

2.13.1.1.4  ALOCReconstFetch 

ALOCReconstFetch  labels  the  radio  buttons  that  display  the  choice  of  forces  in  the 
Admin/Log  Center  Reconst  dialog.  The  function  call  is  ALOCReconstFetch(state).  Table 
2.13-5  describes  the  parameter  used  and  function  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  DialogState 

DevelopmentiSIMNET  ilibmac; 
dialog,  h 

Calls 

Function 

Where  Described 

LabelForceButtons 

See  Section  2.22.1.16.1. 

Table  2.13-5:  ALOCReconstFetch  Information. 


262 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.13.1.1.5  ALOCEvent 

ALOCEvent  is  called  when  an  Admin/Log  Center  Initialize  or  Reconstitute  Dialog  button  is 
pressed.  If  the  OK  button  is  pressed,  the  validity  of  the  data  is  checked,  the  ALOC 
parameters  are  uploaded,  and  an  entry  is  made  in  the  table  of  displaceable  vehicles.  If  the 
Cancel  button  is  pressed,  the  current  dialog  is  taken  down  and  the  overview  dialog  is  put 
up.  The  function  call  is  ALOCEvent(state,  itemNo).  Table  2.13-6  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialoQ.h 

itemNo 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

Do  nothing  upon  return. 

okBItem 

int 

Resource  id  of  OK  button. 

itemNo 

int 

Resource  id  of  button  hit. 

Calls 

Function 

Where  Described 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

UploadALOCParameters 

See  Section  2.13.1.1.2. 

Table  2.13-6:  ALOCEvent  Information. 


2.13.1.2  toc.c 

Development:SIMNET:MCC:SCC:toc.c 

toc.c  contains  routines  for  positioning  and  reconstituting  the  simulated  Tactical  Operations 
Center  vehicles.  Table  2.13-7  describes  the  variables  used  by  toc.c. 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

tocRole 

char 

Standard  C  type. 

tocLocation 

MapCoordinates 

Oevelopment:SIMNET  :libmac: 
map.h 

tocConfiguration 

char 

Standard  C  type. 

tocCancelFiekj 

PushButtonFieldOefn 

DevelopmentiSIMNET  ilibmac; 
dialoa.h 

tocRBFields 

array  of  RBFieldDefn 

Development:SIMNET  :libmac; 
dialog. h 

tocLocationField 

Coordi  natesFieldDef  n 

Development:SIMNET  ;libmac: 
dialog. h 

tocFieldList 

array  of  FieldOefn 

DevelopmentiSIMNET  ilibmac; 
dialog. h 

initTOCDialog 

OialogNodeDefn 

Development;SIMNET  :libmac; 
seguence.h 

reconstTOCDialog 

DialogNodeOefn 

DevelopmentiSIMNET  ilibmac: 
seguence.h 

Table  2.13-7:  toc.c  Variable  Information. 


2.13.1.2.1  LoadCannedTOC 


LoadCannedTOC  loads  Tactical  Operations  Center  canned  data.  The  function  call  is 
LoadCannedTOC().  Table  2.13-8  describes  the  function  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

Stri  ngT  oM  apCoordi  nates 

See  2.22.1.26.1. 

Called  By 

Function 

Where  Described 

LoadCannedData 

See  Section  2.13.8.15.2. 

Table  2.13-8:  LoadCannedTOC  Information. 

2.13.1.2.2  UploadTOCParameters 

UploadTOCParameters  uploads  Tactical  Operations  Center  parameters  to  the  host.  This 
function  will  only  do  something  if  VERSION  is  APPLETALK.  Otherwise,  it  is  just  a 
dummy  function.The  function  call  is  UploadTOCParameters().  Table  2. 13-9  describes  the 
internal  variable  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

req 

SCCTOCR6Qu©st 

DevelopmentiSIMNET  iMCCi 
SCCiSCC.h 

1  Calls  1 

Function 

Where  Described 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

ATPPut 

See  Section  2.22.1.3.3. 
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1  Called  Bv  1 

Function 

Where  Described 

TOCEvent 

See  Section  2.13.1.2.5. 

Table  2.13-9:  UploadTOCParameters  Information. 
2.13.1.2.3  TOCInitFetch 

TOCInitFetch  labels  the  radio  buttons  that  display  the  choice  of  forces  in  the  Tactical 
Operations  Center  Ink  dialog.  The  function  call  is  TOCInitFetch(dialog).  Table  2.13-10 
describes  the  parameter  used  and  function  called  using  this  function. 


I  Parameters  I 

Parameter 

Tvoe 

Where  Tvoedef  Declared 

dialog 

pointer  to  OialogState 

Development;SIMNET  ilibmac; 
dialog,  h 

Calls 

Function 

Where  Described 

LabelForceButtons 

See  Section  2.22.1.16.1. 

Table  2.13-10:  TOCInitFetch  Information. 

2.13.1.2.4  TOCReconstFetch 

TOCReconstFetch  labels  the  radio  buttons  that  display  the  choice  of  forces  in  the  Tactical 
Operations  Center  Reconst  dialog.  The  function  call  is  TOCReconstFetch(diaIog).  Table 
2.13-1 1  describes  the  parameter  used  and  function  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  OialogState 

Development:SIMNET;libmac: 

dialog.h 

Calls 

Function 

Where  Described 

LabelForceButtons 

See  Section  2.22.1.16.1. 

Table  2.13-11:  TOCReconstFetch  Information. 

2.13.1.2.5  TOCEvent 

TOCEvent  is  called  when  a  button  in  the  Tactical  Operations  Center  dialog  is  pressed.  If 
the  OK  button  is  pressed,  the  validity  of  the  data  is  checked,  the  TOC  parameters  are 
uploaded,  and  an  entry  is  made  in  the  table  of  displaceable  vehicles.  If  the  Cancel  button  is 
pressed,  the  current  dialog  is  taken  down  and  the  overview  dialog  is  put  up.  The  function 
call  is  TOCEvent(dialog,  itemNo).  Table  2.13-12  describes  the  parameters  used  and 
functions  called  using  this  function. 
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Parameters 

Parameter 

Type 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialoQ.h 

itemNo 


Standard  C  t 


Return  Value 


okBItem 


itemNo 


Return  Values 


Type 


int 


int 


int 


Meaning  _ 


do  nothing  upon  return 


resource  id  of  the  OK  button 


resource  id  of  the  button  hit 


Function 


CheckMandatorvFields 


UploadTOCParameters 


Calls 


Where  Described 


See  Section  2.22.1.13.1. 


See  Section  2.13.1.2.2. 


Table  2.13-12:  TOCEvent  Information. 

2.13.2  Allocation,  Placement  and  Reconstitution  of  Vehicle  Simulators 


2.13.2.1  alloc. c 

Development:SIMNET:MCC:SCC:alloc.c 

alloc.c  implements  the  user  interface  for  allocating  vehicle  simulators  to  organizational 
units.  Table  2.13-13  describes  the  variables  used  by  alloc.c. 
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1  Variables  1 

Variable 

Where  Typedef  Declared 

allocTableField 

extern  ScrollTableFieldDefn 

Development:SIMNE!  ;libmac; 
scroll. h 

allocColumns 

extern  array  of 
ScrollTableColumnDefn 

DevelopmentiSIMNE!  :libmac: 
scroll.h 

allocEntryDialog 

extern  OialogOefn 

Development:SIMNE!;libmac: 

dialoa.h 

allocatedSim 

pointer  to  SimDescrtptor 

DevelopmentrSIMNE!  :MCC; 
libsimilibsim.h 

allocColumns 

array  of 

Scroll!  ableColumnDefn 

Development:SIMNE!  ;libmac: 
scroll.h 

allocTableField 

Scroll!  ableFieldDef  n 

Development:SIMNE!  ilibmac: 
scroll.h 

allocTableFieldUst 

pointer  to  array  of  FieldDef  n 

DevelopmentrSIMNE!  ilibmac: 
dialoQ.h 

allocTableDialog 

DialogNodeDefn 

DevebpmentrSIMNE!  :libmac; 
sequence. h 

allocEntryFields 

array  of  RBFieldDefn 

DevelopmentiSIMNE!  ;libmac; 
dialog. h 

allocEntryFieldList 

pointer  to  array  of  FieldDefn 

Development:SIMNE!  :libmac: 
dialog. h 

allocEntryDialog 

DialogDefn 

OevelopmentiSIMNE!  :libmac; 
dialog. h 

Table  2.13-13:  alloc.c  Variable  Information. 

2.13.2.1.1  SetUpAlloc 

SetUpAlloc  sets  up  the  Simulator  Allocate  Table  dialog  for  allocating  vehicles.  This  is  the 
table  of  simulators  currently  available  for  allocation  to  units.  The  function  call  is 
SetUpAllocQ.  Table  2.13-14  describes  the  functions  called  using  this  function. 


i  Calls  1 

Function 

Where  Described 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

Text  Size 

Standard  Quickdraw  function  for  Macintosh. 

String  Width 

Standard  Quickdraw  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

Setup 

See  Section  2.13.8.17.1. 

Table  2.13-14: 


SetUpAlloc  Information. 
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2.13.2.1.2  AllocTableFetch 

AUocTableFetch  reads  the  current  values  of  the  present  table  of  simulators  available  for 
allocation  to  units  into  the  dialog  fields  to  display  to  the  user.  The  function  call  is 
AllocTableFetch  (dialog).  Table  2.13-15  describes  the  parameter  used  and  function  called 
using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DeveiopmentiSIMNET  rlibmac: 
dialoq.h 

Calls 

Function 

Where  Described 

SimTableSetup 

See  Section  2.22.2.10.1. 

Table  2.13-15:  AllocTableFetch  Information. 

2.13.2.1.3  AllocTableSelect 

AllocTableSelect  is  called  when  an  entry  in  the  allocation  table  is  selected.  It  checks  for 
validity  of  the  selection  and  brings  up  the  next  dialog  describing  the  selection.  The  function 
call  is  AllocTableSelect(defn,  row,  box,  event).  TaWe  2.13-16  describes  the  parameters 
used  and  functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development:SIMNET  :libmac: 
scroll.h 

row 

int 

Standard  C  type. 

box 

pointer  to  Red 

DevelopmentiTHINK  C; 

Mac  #includes;MacTypes.h 

event 

pointer  to  EventRecord 

DevelopmentiTHINK  C: 

Mac  #includes:EventMgr.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

entry 

register 

ScrollTableEntryHandle 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

Sim 

register  pointer  to 
SimDescriptor 

Development:SIMNET:MCC: 

libsimilibsim.h 

str 

array  of  50  char 

Standard  C  type. 

I  Calls  I 

I  Function 

Where  Described 

lllilli^llllll  III  hill  1 

See  Section  2.22.1.34.1. 

SetScrollTableSelection 

See  Section  2.22.1.37.2. 

SimTableEntry 

See  Section  2.22.2.10.3. 

ShowCaution 

See  Section  2.22.1.4.1. 

ShowDialoa 

See  Section  2.22.1.11.1. 

ZoomUpFromTableEntrv 

See  Section  2.13.8.8.2. 

Table  2.13-16:  AllocTableSelect  Information. 
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2.13.2.1.4  AllocTableEvent 

AllocTableEvent  handles  an  event  in  an  Allocation  Table  dialog.  If  the  Overview  button 
was  pressed,  the  Scroll  Table  is  discarded  and  the  overview  screen  is  put  up.  The  function 
call  is  AllocTableEvent(dialog,  itemNo).  Table  2.13-17  describes  the  parameters  used  and 
function  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  OialogState 

DevebpmentiSIMNET  ilibmac: 
dialOQ.h 

itemNo 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

itemNo 

int 

resource  id  of  the  button 
pressed 

Calls 

Function 

Where  Described 

DisposeScrollTable 

See  Section  2.22.1.30.2. 

Table  2.13-17:  AllocTableEvent  Information. 

2.13.2.1.5  AllocEntryFetch 

AIlocEntryFetch  reads  the  current  values  of  the  simulator  allocation  entry  into  the  dialog 
fields  to  display  to  the  user.  The  simulator  and  type  number  fields  are  set.  The  radio 
buttons  are  set.  Radio  buttons  for  units  not  participating  in  the  exercise  are  disabled.  The 
function  call  is  AllocEntryFetch(dialog).  Table  2.13-18  describes  the  parameter  used  and 
functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogSlate 

Development;SIMNET  :libmac; 
dialog.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

str 

array  of  20  char 

Standard  C  type. 

pStr 

pointer  to  char 

Standard  C  type. 

i 

short 

Standard  C  type. 

I  Calls  I 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

SimulatorTypeCStr 

See  Section  2.22.2.9.2. 

DisableControl 

See  Section  2.22.1.7.1. 

Table  2.13-18:  AllocEntryFetch  Information. 
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2.13.2.1.6  AllocEntryEvent 


AllocEntryEvent  is  called  when  a  button  in  the  Simulator  Allocate  Entry  dialog  is  pressed. 
If  the  OK  button  is  pressed,  the  simulator  entry  is  allocated  to  the  company,  the  scroll  entry 
table  is  taken  down,  and  the  overview  screen  is  put  up.  If  the  Help  button  is  pressed,  the 
Help  dialog  is  put  up.  The  function  call  is  AllocEntryEvent(dialog,  itemNo).  Table 
2.13-19  de^bes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentrSIMNET  :libmac; 
dialOQ.h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

req 

SimAllocRequest 

Deyelopment;SIMNET:MCC; 
include ;sim  xact.h 

Calls 

Function 

Where  Described 

showhelp 

See  Section  2.22.1.19.4. 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

ATPPut 

See  Section  2.22.1.3.3. 

UpdateScrollTable  Entry 

See  Section  2.22.1.31.1. 

ZoomDownToTableEntrv 

See  Section  2.13.8.8.3. 

ThrowDialoq 

See  Section  2.22.1.11.3. 

Table  2.13*19:  AllocEntryEvent  Information. 
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2.13.2.2  place.c 

Development:SIMNET  :M(X:SCC:place.c 

place.c  implements  the  user  interface  for  placing  vehicle  simulators.  Table  2.13-20 
describes  the  variables  used  by  place.c. 


Variables 


Variable 


placeTableOialog 


placeTableField 


placeColumns 


placeSelectFields 


placeSeiectFieldList 


placeSelectDialog 


placeColumns 


placeTableField 


place! able  FieldList 


placeTableOialog 


Where  Tvoedef  Declared 


Standard  C  t 


DevelopmentiSIMNET  :libmac; 
seauence.h 


extern  ScrollTableFieldDefn  Development:SIMNET:libmac; 

scroll.h 


DevelopmentiSIMNET  ilibmac; 
scroll.h 


DevelopmentiSIMNET  ilibmaci 
dialOQ.h 


pointer  to  array  of  FieldDefn  DevelopmentiSIMNET  ilibmaci 

dialOQ.h 


DevelopmentiSIMNET  ilibmaci 
sequence. h 


DevelopmentiSIMNET  ilibmaci 
scroll.h 


DevelopmentiSIMNET  ilibmaci 
scroll.h 


pointer  to  array  of  FieldDefn  DevelopmentiSIMNET  ilibmaci 

dialOQ.h 


DevelopmentiSIMNET  ilibmaci 
sequence. h 


char 


extern  DialogNodeDefn 


extern  array  of 
ScrollTableColumnDefn 


array  of  RBFieldOefn 


DialogNodeDefn 


array  of 

ScrollTableColumnDefn 


ScrollTableFieldDefn 


DialogNodeDefn 


Table  2.13*20:  place.c  Variable  Information. 
2.13.2.2.1  SetUpPiace 

SetUpPlace  sets  up  the  dialog  for  placing  combat  vehicles.  The  function  call  is 
SetUpPlaceQ.  Table  2.13-21  describes  the  functions  called  by  this  function. 


Function 


Text  Font 


TextSize 


Strinq  Width 


Function 


SetU 


Calls 


Where  Described 


Standard  Ouickdraw  function  for  Macintosh. 


Standard  Ouickdraw  function  for  Macintosh. 


Standard  Ouickdraw  function  for  Macintosh. 


Called  B 


Where  Described 


See  Section  2.13.8.17.1. 


Table  2.13-21:  SetUpPlace  Information. 
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2.13.2.2.2  PlaceSelectFetch 


PlaceSelectFetch  reads  the  participating  organizaoonal  units  into  the  Place  Select  dialog 
fields  to  display  to  the  user.  The  Place  Select  dialog  allows  the  user  to  select  the  company 
whose  simulators  are  to  be  placed.  The  function  caiu  is  PlaceSelectFetch(dialog).  Table 
2.13-22  describes  the  parameter  used  and  function  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  OialogState 

Development:SIMNET  :libmac; 
dialog. h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

str 

array  of  50  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

DisabieControl 

See  Section  2.22.1.7.1. 

Table  2.13-22:  PlaceSelectFetch  Information. 

2.13.2.2.3  PlaceSelectEvent 

PlaceSelectEvent  is  called  when  an  event  occurs  in  the  Place  Select  dialog.  The  Next 
button  is  enabled.  The  function  call  is  PlaceSelectEvent(dialog,  itemNo).  Table  2.13-23 
describes  the  parameters  used  and  function  called  using  ^is  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  OialogState 

DevelopmentiSIMNET  ;libmac: 
dialog.h 

itemNo 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

itemNo 

int 

resource  id  of  the  button 
pressed 

Calls 

Function 

Where  Described 

EnableControl 

See  Section  2.22.1.7.2. 

Table  2.13-23:  PlaceSelectEvent  Information. 
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2.13.2.2.4  PlaceTableFetch 

PlaceTableFetch  reads  the  selected  company's  simulators  into  the  Place  Table  dialog  fields 
to  display  to  the  user.  The  function  call  is  PlaceTableFetch(dialog).  Table  2.13-24 
describes  the  parameter  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  ilibmac; 
dialog. h 

1  Calls  1 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

See  Section  2.22.2.10.1. 

Table  2.13*24:  PlaceTableFetch  Information. 

2.13.2.2.5  PlaceComplete 

PlaceComplete  is  called  to  take  down  the  Place  Table  dialog  when  a  selection  is 
successfully  placed.  The  function  call  is  PlaceComplete(sim,  success).  Table  2.13-25 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Tvoedef  Declared 

Sim 

pointer  to  SimDescriptor 

Development.SIMNET.MCC: 

libsimilibsim.h 

success 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

UpdateScrollTableEntrv 

See  Section  2.22.1.31.1. 

ZoomDownToTableEntrv 

See  Section  2.13.8.8.3. 

Table  2.13*25:  PlaceComplete  Information. 

2.13.2.2.6  PlaceTableSelect 

PlaceTableSelect  is  called  when  an  entry  in  the  place  table  is  selected.  It  checks  for  validity 
of  the  selection  and  pops  up  the  dialog  for  placing  the  vehicle.  The  function  call  is 
PlaceTableSelect(defn,  row,  bo.’c,  event).  Table  2. 13-26  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development.SIMNET  ;libmac. 
scroll. h 

row 

int 

Standard  C  type. 

box 

pointer  to  Rect 

Developmenf.THINK  C: 

Mac  #includes;MacTvpes.h 

event 

pointer  to  EventRecord 

Development.THINK  C; 

Mac  #includes:EventMqr.h 
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Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

entry 

register 

ScrollT  ableEntrvHandle 

Development;SIMNET  :libmac: 
scroll.h 

btiil 

register  pointer  to 
SimDescriptor 

Development:SIMNET  :MCC; 
libsimilibsim.h 

1  Calls  1 

Function 

Where  Described 

ScrollTableRowToEntrv 

See  Section  2.22.1.34.1. 

SetScrollTableSelection 

See  Section  2.22.1.37.2. 

SimTableEntrv 

See  Section  2.22.2.10.3. 

ShowCaution 

See  Section  2.22.1.4.1. 

See  Section  2.22.2.9.5. 

1  ZoomUpFromTableEntrv 

See  Section  2.13.8.8.2. 

Table  2.13-26:  PlaceTableSelect  Information. 

2.13.2.2.7  PlaceTableEvent 

PlaceTableEvent  is  called  when  an  event  occurs  in  the  place  table  dialog.  If  the  Overview 
button  was  pressed,  the  scroll  table  is  discarded  and  the  overview  screen  is  put  up.  The 
item  number  of  the  event  is  returned.  The  function  call  is  PlaceTableEvent(dialog, 
itemNo).  Table  2.13-27  describes  the  parameters  used  and  function  called  using  this 
function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  OialogState 

Development:SIMNET  :libmac: 
dialoQ.h 

itemNo 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

itemNo 

int 

resource  id  of  the  button 
pressed 

Calls 

Function 

Where  Described 

DisposeScrollTable 

See  Section  2.22.1.30.2. 

Table  2.13-27:  PlaceTableEvent  Information. 
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SimulatorPlaced 


SimulatorPlaced  notes  that  a  simulator,  sim,  has  been  placed  by  another  console.  If  a  table 
of  simulators  is  being  displayed,  the  screen  is  updated.  The  function  call  is 
SimulatorPlaced(sim).  Table  2.13-28  describes  the  parameter  used  and  function  called 
using  this  function. 


Parameters 

Parameter  [Type  [Where  Typedef  Declare'd 

Sim  register  pointer  to  Development;SlMNET:MCC: 

SimPescriptor_ libsim:libsim.h 


_ _ Calls _ 

Function  Where  Described 

SimTableUpdate_ See  Section  2.22.2.10.2. 


_  Called  By _ 

Function _ Where  Described _ 

ProcessRe2ues^__,^____^_,See_^ectioiT^J3^8^;6JL^^^_^^^____ 

Table  2.13-28:  SimulatorPlaced  Information. 


2.13.3  Simulation  of  Combat  Service  Support 


2.13.3.1  css.c 

Development:SIMNET  :MCC:SCC:css.c 

css.c  implements  the  user  interface  for  specifying  the  organization  of  combat  service 
support  assets,  and  the  default  locations  of  those  assets.  Table  2.13-29  describes  the 
variables  used  by  css.c. 
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1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

cssTypeDialog 

extern  DialogNodeDefn 

Development:SIMNET  ilibmac: 
seauence.h 

orgTrainsDialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac: 
seauence.h 

echTrainsDialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac: 
seauence.h 

unitTrainsDiaiog 

extern  DialogNodeDefn 

Development.SIMNET.'libmac. 

seauence.h 

ammoT ruckT able  Dialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac: 
seauence.h 

supply  Depots  Dialog 

extern  DialogNodeDefn 

DevelopmentrSIMNET  ilibmac; 
seauence.h 

umcpDialog 

extern  DialogNodeDefn 

Development:SIMNET  iKbmac; 
seauence.h 

supplyRatesDialog 

extern  DialogNodeDefn 

Development;SIMNET  ilibmac: 
seauence.h 

depotsConfirmDialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac: 
seauence.h 

cssConfirmDialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac: 
seauence.h 

extern  char 

Standard  C  type. 

cssTvpeBuffer 

char 

Standard  C  type 

cssTypeFields 

array  of  RBFieldDefn 

Devetopment;SIMNET  ;libmac; 
dialoa  h 

cssTypeFieldList 

pointer  to  array  of  FiekfDefn 

DeyelopmentiSIMNET  :libmac; 
dialoa.h 

cssTypeDialog 

DialogNodeDefn 

Development.SIMNET  ilibmac: 
seauence.h 

orgTrainsFields 

array  of  RBFieldDefn 

Development:SIMNET  :libmac: 
dialoa.h 

orgTrainsFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentrSIMNET  rlibmac: 
dialoa.h 

orgTransDialog 

DialogNodeDefn 

DevelopmentrSIMNET  rlibmacr 
seauence.h 

unitTrainsField 

CoordinatesFieldDefn 

DevelopmentrSIMNET  rlibmacr 
dialoa.h 

unitTrainsFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentrSIMNET  rlibmacr 
dialog. h 

unitTrainsDiaiog 

DialogNodeDefn 

DevelopmentrSIMNET  rlibmacr 
seauence.h 

echTrainsFields 

array  of  CoordinatesFieldDefn 

DevelopmentrSIMNET  rlibmacr 
dialoa.h 

echTrainsFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentrSIMNET  rlibmacr 
dialoa.h 

echTrainsDialog 

DialogNodeDefn 

DevelopmentrSIMNET  rlibmacr 
seauence.h 

cssConfirmFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentrSIMNET  rlibmacr 
dialoa.h 

cssConfirmDialog 

DialogNodeDefn 

DevelopmentrSIMNET  rlibmacr 
seauence.h 

Table  2.13-29:  css.c  Variable  Information. 
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2.13.3.1.1  LoadCannedCSS 

LoadCannedCSS  loads  canned  CSS  initialization  data.  The  function  call  is 
LoadCannedCSSO.  Table  2.13-30  describes  the  internal  variable  used  and  function  called 
using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

Calls 

Function 

Where  Described 

StringToMapCoordinates 

See  Section  2.22.1.26.1. 

Called  Bv 

Function 

Where  Described 

LoadCannedData 

See  Section  2.13.8.15.2. 

Table  2.13-30:  LoadCannedCSS  Information. 

2.13.3.1.2  CSSTypeFetch 

CSSTypeFetch  sets  up  the  CSS  Types  in  the  dialog  fields  to  display  to  the  user.  The  radio 
buttons  for  initialized  CSS  types  are  disabled  in  the  CSS  Type  dialog.  The  function  call  is 
CSSTypeFetch(state).  Table  2.13-31  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac; 
dialog. h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

itemType 

int 

Standard  C  type. 

theltem 

Handle 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

box 

Rect 

Deyelopment:THINK  C: 

Mac  #includes:MacTypes.h 

Calls 

Function 

Where  Described 

DisableControl 

See  Section  2.22.1.7.1. 

Table  2.13-31;  CSSTypeFetch  Information. 
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2.13.3.1.3  CSSTypeBranch 

CSSTypeBranch  brings  up  the  correct  dialog  for  the  CSS  Type  selected.  A  handle  to  the 
next  di^og  to  pop  up  is  returned.  The  function  call  is  CSSTypeBranch(state).  Table 
2.13-32  describes  the  parameter  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  DiaiogSeqState 

DevelopmentrSIMNET  :libmac; 
sequence. h 

Return  Values 

Return  Value 

Type 

Meaning 

cssTypeBuffer 

pointer  to  DialogNodeDefn 

Handle  to  next  dialog  to  pop¬ 
up. 

Table  2.13-32:  CSSTypeBranch  Information. 

2.13.3.1.4  DefauitTrainsEvent 

DefaultTrainsEvent  is  called  when  a  button  in  one  of  the  trains  dialogs  is  pressed.  It 
determines  whether  the  data  entered  is  valid.  It  throws  the  current  dialog  away  and  goes  to 
the  main  screen.  It  returns  the  item  number  of  the  button  pressed.  The  function  call  is 
DefaultTrainsEvent(state,  itemNo).  Table  2.13-33  descries  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  DialogState 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

do  nothing  upon  return 

itemNo 

int 

resource  id  of  the  button  hit 

Calls 

Function 

Where  Described 

CheckMandatorvFields 

See  Section  2.22.1.13.1. 

ToickDefaultAII 

See  Section  2.13.3.4.2. 

Table  2.13-33: 


DefaultTrainsEvent  Information. 
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2.13.3.1.5  OrgTrainsBranch 

OrgTrainsBranch  checks  the  type  of  item  selected  (whether  trains  are  unit  or  echeloned)  and 
brings  up  the  next  dialog  depending  on  the  item  type.  It  returns  a  handle  to  the  next  didog 
to  pop  up.  The  function  call  is  OrgTrainsBranch(state).  Table  2.13-34  describes  the 
parameter  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

state 

pointer  to  OialogSeqState 

Development:SIMNET  ;libmac: 
sequence. h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

trainsOrganization 

pointer  to  DialogNodeDefn 

a  handle  to  the  next  dialog 

Table  2.13-34:  OrgTrainsBranch  Information. 

2.13.3.1.6  UploadCSSParameters 

UploadCSSParameters  uploads  the  CSS  parameters  to  the  host.  This  function  is  only  valid 
when  VERSION  is  APPLETALK.  Otherwise  it  is  a  dummy  function.  The  function  call  is 
UploadCSSParameters().  Table  2.13-35  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

cReq 

SCCCSSRequest 

Development:SIMNET  :MCC; 
SCC;SCC.h 

truck 

pointer  to  TruckDescriptor 

Development:SIMNET  :MCC: 
SCCIruck.h 

i 

int 

Standard  C  type. 

i 

int 

Standard  C  type. 

box 

Rect 

savePort 

GrafRr 

Deyelopment:THINK  C: 

Mac  #includes;Quickdraw.h 

str 

pointer  to  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

ShowWait 

See  Section  2.22.1.45.1. 

Upload!  njckParameters 

See  Section  2.13.3.6.1. 

ATPPut 

See  Section  2.22.1.3.3. 

Throw  Wait 

See  Section  2.22.1.45.2. 

1  Called  By  1 

Function 

Where  Described 

CSSConfirmEvent 

See  Section  2.13.3.1.8. 

Table  2.13-35:  UploadCSSParameters  Information. 
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2.13.3.1.7  CSSConfirmFetch 

CSSConfirmFetch  reads  the  choices  of  the  CSS  confirmation  into  the  dialog  fields  to 
display  to  the  user.  The  function  call  is  CSSConfirmFetch(state).  Table  2.13-36  describes 
the  parameter  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

state 

pointer  to  OialogState 

Development:SIMNET  :libmac: 
dialoq.h 

1  Calls  1 

Function 

Where  Described 

ParamText 

Standard  Dialoa  Manaaer  function  for  Macintosh. 

SetWTitle 

Standard  Window  Manaaer  function  for  Macintosh. 

Table  2.13-36:  CSSConfirmFetch  Information. 

2.13.3.1.8  CSSConfirmEvent 

CSSConfirmEvent  is  called  when  a  button  in  the  CSS  Confirm  dialog  is  pressed.  If  the 
OK  button  was  pressed,  the  CSS  parameters  are  uploaded.  The  item  number  of  the  button 
pressed  is  returned,  and  the  overview  screen  is  put  up.  The  function  call  is 
CSSConfirmEvent(state,  itemNo).  Table  2.13-37  describes  the  parameters  used  and 
functions  called  vsing  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvoedef  Declared 

state 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialoq.h 

itemNo 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

the  OK  button  was  pressed 
and  the  CSS  parameters  are 
uploaded 

itemNo 

int 

resource  id  of  the  button  hit 

Calls 

Function 

Where  Described 

UploadCSSParameters 

See  Section  2.13.3.1.6. 

DialogSeqNext 

See  Section  2.22.1.39.4. 

Table  2.13-37:  CSSConfirmEvent  Information. 
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2.13.3.2  depots.c 

Development;SIMNET:MCC:SCC;depots.c 

depots.c  implements  the  user  interface  for  locating  supply  depots  and  establishing 
ammunition  controlled  supply  rates.  Table  2.13-38  describes  the  variables  used  by 
depots.c. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

suppiyDepots  Dialog 

extern  DialogNodeDefn 

Development.’SIMNET  ;libmac: 
sequence. h 

supplyRatesDialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac; 
sequence. h 

depotsConf  i  rmDi  alog 

extern  DialogNodeDefn 

DevelopmentiSIMNET  ilibmac: 
sequence. h 

char 

Standard  C  type. 

supplyDepotsFields 

array  of  CoordinatesFieldDefn 

Development:SIMNET  :libmac; 
dialog. h 

supplyDepotsFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  :libmac: 
dialog. h 

supplyDepotsDialog 

DialogNodeDefn 

Development;SIMNET  :libmac: 
sequence. h 

supplyRatesFields 

array  of  NumberFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

supplyRatesFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

supplyRatesDialog 

DialogNodeDefn 

DevelopmentiSIMNET  ilibmac: 
sequence. h 

depotsConfirmFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

depotsConfirmDialog 

DialogNodeDefn 

DevelopmentiSIMNET  ilibmac: 
sequence. h 

Table  2.13-38:  depots.c  Variable  Information. 

2.13.3.2.1  DepotConfirmFetch 

DepotConfirmFetch  reads  the  supply  depot  initialization  choices  into  the  Depot  Confirm 
dialog  fields  to  display  to  the  user.  The  function  call  is  DepotConfirmFetch(state).  Table 
2.13-39  describes  the  parameter  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  DialogState 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

Calls 

Function 

Where  Described 

ParamText 

Standard  Dialog  Manager  function  for  Macintosh. 

SetWTitle 

Standard  Window  Manager  function  for  Macintosh. 

Table  2.13-39:  DepotConfirmFetch  Information. 


281 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.13.3.2.2  DepotConfirmEvent 


DepotConfirmEvent  is  called  when  a  button  in  the  Depot  Confirm  dialog  is  pressed.  It 
determines  whether  the  data  entered  is  valid.  If  the  OK  button  was  pressed,  the  supply 
depots  are  initialized,  the  UMCP  and  depots  are  placed  into  the  table  of  displaceable 
entities,  and  the  overview  screen  is  put  up.  Otherwise,  the  item  number  of  the  button 
pressed  is  returned.  The  function  call  is  DepotConfinnEvent(state,  itemNo).  Table 
2.13-40  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  DialogState 

Development:SIMNET  :libmac; 
dialoq.h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

req 

SCCDepotsRequest 

Development  ;SIM  NET  :MCC: 
SCCrSCC.h 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

OK  button  was  pressed  and 
the  supply  depots  are 
initialized 

itemNo 

int 

resource  id  of  button  hit 

Calls 

Function 

Where  Described 

ATPPut 

See  Section  2.22.1.3.3. 

DialoqSeqNext 

See  Section  2.22.1.39.4. 

Table  2.13-40:  DepotsConfirmEvent  Information. 

2.13.3.3  truckentry.c 

Development:SIMNET:MCC:SCC:truckentry.c 

truckentry.c  implements  dialogs  for  initializing  or  reconstituting  individual  supply  trucks 
and  maintenance  teams.  Table  2.13-41  describes  the  variables  used  by  truckentiy.c. 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

currentTruck 

pointer  to  TruckDescriptor 

Development:SIMNET  iMCC; 
SCCiruck.h 

truckBuffer 

TruckDescriptor 

Development  :SIMNET  :MCC : 
SCCiruck.h 

fuelBuffer 

int 

Standard  C  tvoe. 

(completion  Routi  ne)  0 

void  function  call 

Standard 

transferWindow 

WindowPtr 

Development.THINK  C: 

Mac  #includes:WindowMgr.h 

transferZoomRect 

Red 

DevetopmentiTHINK  C; 

Mac  #includes;MacTypes.h 

supplyDepot 

Manifest 

Development;SIMNET. 

include.resuPDlv.h 

tmckParty 

TransferParty 

Development:SIMNET; 

libsupplylibsupply.h 

depotParty 

TransferParty 

Development:SIMNET ; 
libsupplylibsupply.h 

truckAmmoField 

extern  ScrollTabfeFieldDefn 

DevelopmenttSIMNETlibmac; 
scroll. h 

ammoTruckEntry  Dialog 

extern  DialogDefn 

DevelopmentiSIMNET  libmac; 
dialog. h 

fuelT  ruckEntryOialog 

extern  DialogDefn 

Development;SIMNET  libmac: 
dialog. h 

maintTruckEntry  Dialog 

extern  DialogDefn 

DevelopmentiSIMNET  ilibmac; 
dialog. h 

truckCancelField 

PushButtonFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

truckAssignFields 

array  of  RBFiekJDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

truckSideFields 

array  of  RBFiekjDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

truckLocationField 

CoordinatesFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

truckAmmoField 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmac: 
scroll. h 

truckFuelField 

NumberFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

ammoT  ruckfieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

fuelTruckFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

mainlTruckFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

ammoT  ruckEntry  Dialog 

DialogDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

fuelT  ruckEntryDialog 

DialogDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

maintTruckEntryDialog 

DialogDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

Table  2.13-41:  truckentry.c  Variable  Information. 
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2.13.3.3.1  ShowTruckDialog 


ShowTruckDialog  shows  the  dialog  for  initializing  or  reconstituting  an  ammo,  fuel,  or 
maintenance  truck.  The  function  call  is  ShowTmckDialog(truck,  completion).  Table 
2.13-42  describes  the  parameters  used  and  functions  call^  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

truck 

pointer  to  TruckDescriptor 

Development:SIMNET  :MCC: 
SCCrtruck.h 

(completion)() 

void  function  call 

Standard 

Internal  Variables 

Variable 

Where  Typedef  Declared 

dialog 

pointer  to  array  of  DialogDefn 

Development:SIMNET  :libmac; 
dialog. h 

1  Calls  1 

Function 

Where  Described 

ShowDialoq 

See  Section  2.22.1.11.1. 

1  Called  By  I 

Function 

Where  Described 

TruckTableSelect 

See  Section  2.13.3.4.11. 

TruckReconstStart 

See  Section  2.13.5.3.2. 

Table  2.13*42:  ShowTruckDialog  Information. 


2.13.3.3.2  UpdateAmmoLoadTotals 


UpdateAmmoLoadTotals  updates  the  weight  and  volume  totals  displayed  for  the  current 
ammunition  truck.  The  function  call  is  U^ateAmmoLoadTotalsQ.  Table  2.13-43 
describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

weight 

long 

Standard  C  type. 

volume 

long 

Standard  C  type. 

str 

array  of  50  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

T otal  AmmoCapacitv 

See  Section  2.22.3.9.1. 

SetText 

See  Section  2.22.1.11.8. 

1  Called  By  1 

Function 

Where  Described 

TruckEntry  Fetch 

See  Section  2.13.3.3.3. 

TruckEntry  Event 

See  Section  2.13.3.3.4. 

AmmoTransferComplete 

See  Section  2.13.3.3.6. 

Table  2.13-43:  UpdateAmmoLoadTotals  Information. 
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2.13.3.3.3  TruckEntryFetch 

TruckEntryFetch  reads  the  current  values  of  the  truck  data  structures  into  the  dialog  fields 
to  display  to  the  user.  The  vehicle  field  number  is  set,  radio  buttons  for  companies  not 
participating  in  this  exercise  are  disabled,  the  fenee  alignment  buttons  are  labeled  and 
enabled,  and  the  ammo  list  is  displayed  for  ammo  trucks.  The  function  call  is 
TruckEntryFetch(dialog).  Table  2.13-44  describes  the  parameters  used  and  functions 
called  using  this  function. 


Parameter 


dialog 


Parameters 


IEI73 


pointer  to  DialogState 


Where  Tvoedef  Declared 


Development:SIMNET:libmac; 

dialOQ.h 


Variable 


Internal  Variables 


e 


reqister  short 


array  of  char 


Where  Tvoedef  Declared 


Standard  C  tvoe. 


Standard  C  type. 


Function 


SetText 


DisableControl 


LabelForceButtons 


TruckDefaultAliqnment 


FillAmmunitionList 


UpdateAmmoLoadTotals 


Calls 


Where  Described 


See  Section  2.22.1.11.8. 


See  Section  2.22.1.7.1. 


See  Section  2.22.1.16.1. 


See  Section  2.13.3.4.4. 


See  Section  2.22.3.5.1. 


See  Section  2.13.3.3.2. 


Table  2.13-44;  TruckEntryFetch  Information. 

2.13.3.3.4  TruckEntryEvent 

TruckEntryEvent  is  called  to  process  data  when  a  button  in  the  truck  entry  dialog  is 
pressed.  The  routine  determines  if  the  data  entered  is  valid,  then  updates  the  didog.  The 
function  call  is  TruckEntryEvent(dialog,  itemNo).  Table  2.13-45  describes  the  parameters 
used  and  functions  called  using  this  function. 


Parameter 


dialog 


itemNo 


Parameters 


pointer  to  DialogState 


Where  Tvoedef  Declared 


DevelopmentiSIMNET  :libmac; 
dialoo.h 


Standard  C  type. 


Internal  Variables 


Variable 


volume 


weiqht 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Return  Values 


Return  Value 


Meanin 


do  nothing  upon  return 
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1  Calls  1 

Function 

Where  Described 

CheckMandatoryFields 

See  Section  2.22.1.13.1 

iiiiiin  HI  Mill  — 

See  Section  2.22.3.9.1. 

ShowCaution 

See  Section  2.22.1.4.1. 

DisposeScrollTable 

See  Section  2.22.1.30.2. 

TruckDefautt 

See  Section  2.13.3.4.3. 

LabelForceButtons 

See  Section  2.22.1.16.1. 

T  oickDef  aultAlianment 

See  Section  2.13.3.4.4. 

UpdateAmmoList 

See  Section  2.22.3.5.12. 

UpdateAmmoLoadT  otals 

See  Section  2.13.3.3.2. 

UpdateOialoQ 

See  Section  2.22.1.11.2. 

Table  2.13-45:  TruckEntryEvent  Information. 

2.13.3.3.5  AmmoTableSelect 

AmmoTableSelect  is  called  when  an  entry  in  the  Ammo  Table  is  selected.  It  checks  for 
validity  of  the  selection  and  brings  up  the  Ammo  Transfer  dialog.  The  function  call  is 
AmmoTableSelect(defn,  row,  rect,  theEvent).  Table  2.13-46  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Devetopment:SIMNET  ilibmac: 
scroll.h 

row 

int 

Standard  C  type. 

rect 

pointer  to  Rect 

Development.THINK  C: 

Mac  #includes;MacType3.h 

theEvent 

pointer  to  EventRecord 

DevelopmentiTHINK  C: 

Mac  #includes:EventMqr.h 

1  Calls  1 

Function 

Where  Described 

ShowTransferAmmoDialoq 

See  Section  2.22.3.4.1. 

ZoomTo  Window 

See  Section  2.22.1.47.4. 

ShowWindow 

Standard  Window  Manager  function  for  Macintosh. 

Table  2.13-46: 


AmmoTableSelect  Information. 
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2.13.3.3.6 


AmmoT  ransferComplete 


Ammol'ransferComplete  is  called  to  take  down  the  Ammo  Transfer  dialog  when  the 
transfer  has  been  completed.  The  ammo  list  and  ammo  load  totals  are  updated.  The 
function  call  is  AmmoTransferComplete().  Table  2.13-47  describes  the  functions  called 
using  this  function. 


I  Calls  1 

Function 

Where  Described 

HideWindow 

Standard  Window  Manaoer  function  for  Macintosh. 

ZoomTo  Window 

See  Section  2.22.1.47.4. 

UpdateAmmoList 

See  Section  2.22.3.5.12. 

UpdateAmmoLoadT  otals 

See  Section  2.13.3.3.2. 

Table  2.13-47:  AnunoTransferComplete  Information. 

2.13.3.4  trucktable.c 

Development:  SIMNET  :MCC:  S  CC:  trucktable.c 


trucktable.c  implements  dialogs  displaying  tables  of  supply  trucks.  Table  2.13-48 
describes  the  variables  used  by  trucktable.c. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

truckDistribution 

array  of  LongPt 

Development;SIMNET  ilibmac; 
longpt.h 

defaultArTimoLoad[numberBn 

977Vehicles][numberAmmoV 

arietiesl 

matrix  of  short 

Standard  C  type. 

fuelTruckTableDialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac; 
sequence. h 

maintTruckTableDialog 

extern  DialogNodeDefn 

DevelopmentiSIMNET  :libmac; 
sequence. h 

supplyDepotsDialog 

extern  DialogNodeDefn 

DevelopmentiSIMNET  :libmac: 
sequence. h 

ammoTruckTableField 

extern  FixTableFieldDefn 

DevelopmentiSIMNET  :libmac: 
table. h 

f  uelT  ruckT  ableField 

extern  FixTableFieldDefn 

DevelopmentiSIMNET  ilibmaci 
table. h 

maintTruckField 

extern  FixTableFieldDefn 

DevelopmentiSIMNET  ilibmaci 
table. h 

ammoT  ruckT  ableColumns 

extern  array  of 

FixT  ableColumnDefn 

DevelopmentiSIMNET  ilibmaci 
table. h 

f  uelT  ruckT  ableColumns 

extern  array  of 

FixT  ableColumnDefn 

DevelopmentiSIMNET  ilibmaci 
table. h 

maintT  ruckT  ableColumns 

extern  array  of 

FixT  ableColumnDefn 

DevelopmentiSIMNET  ilibmaci 
table. h 

truckTable 

pointer  to  FixTableFieldDefn 

DevelopmentiSIMNET  ilibmaci 
table. h 

selectRow 

short 

Standard  C  type. 

bvAmmoType 

char 

Standard  C  type. 

(Table  2.13-48  is  continued  on  the  following  page.) 
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Variable 

Type 

Where  Typedef  Declared 

ammoTruckTableField 

FixTableFieldDefn 

DevelopmentiSIMNET  ilibmac; 
table.h 

ammoT  ruckLoadFields 

array  of  RBFieldDefn 

Development:SIMNET  ;libmac: 
dialOQ.h 

ammoT  ruckT ableFieWList 

pointer  to  array  of  FiekJDefn 

Development;SIMNET;libmac: 
dialog. h 

ammoT  ruckT  ableDialog 

DialogNodeDefn 

DevelopmentiSIMNET  :libmac; 
sequence. h 

fuelT  ruckT  ableColumns 

array  of  FixTableColumnDefn 

Oevelopment:SIMNET  :libmac; 
table.h 

fuelT  ruckT  ableField 

FixTableFieldDefn 

DevelopmentiSIMNET  ilibmac: 
table.h 

fuelTruckTableFieldList 

pointer  to  array  of  FiekfDefn 

DevelopmentiSIMNET  ilibmaci 
dialOQ.h 

fuelT  aickT  ableDialog 

DialogNodeDefn 

DevetopmentiSIMNET  ilibmaci 
sequence. h 

maintTruckT  ableColumns 

array  of  FixTableColumnDefn 

DevelopmentiSIMNET  ilibmaci 
table.h 

maintTruckField 

FixTableFieldDefn 

DevelopmentiSIMNET  ilibmaci 
table.h 

maintTruckTableFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialOQ.h 

cssConfirmDialog 

extern  DialogNodeDefn 

DevelopmentiSIMNET  ilibmaci 
sequence. h 

maintT  ruckT  ableDialog 

DialogNodeDefn 

DevelopmentiSIMNET  ilibmaci 
sequence. h 

Table  2.13-48:  trucktable.c  Variable  Information. 


2.13.3.4.1  SetUpTrucks 


SetUpTrucks  initializes  the  truck  tables.  The  function  call  is  SetUpTrucks().  Table 
2.13-49  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

TextSize 

Standard  Quickdraw  function  for  Macintosh. 

StrinqWidth 

Standard  Quickdraw  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

Setup 

See  Section  2.13.8.17.1. 

Table  2.13-49:  SetUpTrucks  Information. 
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2.13.3.4.2  TruckDefaultAII 

TruckDefaultAU  gives  default  values  to  all  truck  parameters  for  the  truck  pointed  to  by 
trucL  The  function  call  is  TruckDefaultAllO.  Table  2. 13-50  describes  the  internal 
variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Tvoedef  Declared 

i 

reqister  short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

TruckDefault 

See  Section  2.13.3.4.3. 

1  Called  Bv  1 

Function 

Where  Described 

DefauItTrai  ns  Event 

See  Section  2.13.3.1.4. 

Table  2.13*50:  TruckDefaultAII  Information. 

2.13.3.4.3  TruckDefault 

TruckDefauU  restores  the  default  values  to  the  specified  truck's  initial  parameters.  The 
function  call  is  TruckDefault(ti‘uck).  Table  2.13-51  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

truck 

register  pointer  to 
TruckDescriptor 

Development:SIMNET  ;MCC: 
SCCiruck.h 

Internal  Variables 

Variable 

Type 

Where  Tvoedef  Declared 

i 

reqister  short 

Standard  C  type. 

Pt 

LongPt 

Development.SIMNET.libmac; 

lonqpt.h 

1  Calls  1 

Function 

Where  Described 

T  ruckDefaultAliqnment 

See  Section  2.13.3.4.4. 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

1  Called  Bv  1 

Function 

Where  Described 

TruckDefaultAII 

See  Section  2.13.3.4.2. 

TruckEntryEvent 

See  Section  2.13.3.3.4. 

Table  2.13*51:  TruckDefault  Information. 
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2.13.3.4.4  TruckDefauU Alignment 


TruckDefaultAlignment  returns  the  default  alignment  of  truck  according  to  the  company. 
The  function  call  is  TruckDefaultAlignment(tmck).  Table  2.13-52  describes  the  parameters 
used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

truck 

pointer  to  Truck  Descriptor 

Defvelopment.'SIMNET  :MCC; 
SCCiruck.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

forcelD 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

forcelD 

int 

Force  to  which  truck  belongs. 

Called  By 

Function 

Where  Described 

TruckDefautt 

See  Section  2.13.3.4.3. 

TruckEntrvFetch 

See  Section  2.13.3.3.3. 

TruckEntrvEvent 

See  Section  2.13.3  3.4. 

Table  2.13-52:  TruckDefaultAlignment  Information. 

2.13.3.4.5  AmmoTruckTableFetch 

AmmoTruckTableFetch  reads  the  current  values  of  the  Ammo  Truck  Table  into  the  dialog 
fields  to  display  to  the  user.  The  Ammo  Truck  Table  displays  the  trucks’  initial  parameters. 
The  function  call  is  AmmoTruckTableFetch(dialog).  Table  2.13-53  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialog. h 

Calls 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

Table  2.13-53:  AmmoTruckTableFetch  Information. 

2.13.3.4.6  AmmoTruckTableEvent 

AmmoTruckTableEvent  is  called  when  a  button  in  the  ammo  truck  table  dialog  is  pressed. 
The  validity  of  the  choice  is  checked,  and  the  data  entered  is  processed.  It  throws  the 
current  dialog  away  and  goes  to  the  main  screen.  The  item  number  of  the  button  pressed  is 
returned.  The  function  call  is  AmmoTruckTableEvent(state,  itemNo).  Table  2.13-54 
describes  the  parameters  used  and  functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Where  Typedef  Declared 

state 

pointer  to  Dialog  State 

DevelopmentiSIMNET  ilibmac: 
diatog.h 

itemNo 

int 

Standard  C  type. 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

theltem 

Handle 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

rect 

Rect 

DevetopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

savePort 

GrafRr 

Devetopment:THINK  C: 

Mac  #includes;Quickdraw.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

itemNo 

int 

resource  id  of  the  button  hit 

1  Calls  1 

Function 

Where  Described 

GetDItem 

Standard  Dialoo  Manager  function  for  Macintosh. 

GetPoft 

Standard  Quickdraw  function  for  Macintosh. 

Set  Port 

Standard  Quickdraw  function  for  Macintosh. 

InvalRect 

Standard  Window  Manager  function  for  Macintosh. 

Table  2.13*54:  AmmoTruckTableEvent  Information. 


2.13.3.4.7  FuelTruckTableFetch 


FuelTruckTableFetch  sets  the  text  of  the  fuel  truck  table  into  the  dialog  fields  to  display  to 
the  user.The  function  call  is  FuelTruckTableFetch(dialog).  Table  2.13-55  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  Dialog  State 

Development:SIMNET  :libmac; 
dialog,  h 

1  Calls  1 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

Table  2.13-55:  FuelTruckTableFetch  Information. 
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2.13.3.4.8  MaintTruckTableFetch 

MaintTruckTableFetch  sets  the  text  of  the  maintenance  truck  table  into  the  dialog  fields  to 
display  to  the  user.The  function  call  is  MaintTruckTableFetch(dialog).  Table  2.13-56 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  Dialog  State 

Development:SIMNET  ilibmac: 
dialoQ.h 

1  Calls  1 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

Table  2.13-56:  MaintTruckTableFetch  Information. 
2.13.3.4.9  TruckTableComplete 

TruckTableComplete  is  called  when  an  entry  in  the  Truck  Table  has  been  successfully 
completed.  The  entry  dialog  is  taken  down,  the  Truck  Table  is  updated,  and  the  Truck 
Table  dialog  is  put  up.  The  function  call  is  TruckTableComplete( success).  Table  2.13-57 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

success 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

UodateFixT able  Row 

See  Section  2.22.1.42.2. 

ZoomDownToTable  Entry 

See  Section  2.13.8.8.3. 

ThrowDialoq 

See  Section  2.22.1.11.3. 

Table  2.13-57:  TruckTableComplete  Information. 

2.13.3.4.10  TruckTableSelect 

TruckTableSelect  is  called  when  an  entry  in  a  truck  table  is  selected.  The  selected  entry  is 
highlighted,  and  a  dialog  is  opened  for  it.  The  function  call  is  TruckTableSelect(defn,  row, 
box).  Table  2.13-58  describes  the  parameters  used  and  functions  called  using  this 
function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

Deyelopment:SIMNET  ;libmac: 
table.h 

row 

int 

Standard  C  type. 

box 

pointer  to  Red 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

I  I 
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1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

but 

register  pointer  to 
TruckTableData 

DevelopmentiSIMNET  :MCC; 
SCCiruck.h 

r 

Rect 

HiH 

savePort 

GrafRr 

DevelopmentTHINK  C: 

Mac  #includes:Quickdraw.h 

1  Calls  1 

Function 

Where  Described 

Get  Port 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

FixTableRowRect 

See  Section  2.22.1.42.5. 

InvertRect 

Standard  Quickdraw  function  for  Macintosh. 

ShowTruckDialoa 

See  Section  2.13.3.3.1. 

ZoomUpFromTableEntry 

See  Section  2.13.8.8.2. 

Table  2.13-58:  TruckTableSelect  Information. 


2.13.3.4.11  TruckTableHilite 


TruckTableHilite  changes  the  appearance  of  the  given  selection  so  the  user  knows  the  item 
is  selected.  The  text  is  inverted.  The  function  call  is  TruckTableHilite(defn,  row,  box). 
Table  2.13-59  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

Development:SIMNET  ilibmac; 
table.h 

row 

int 

Standard  C  type. 

box 

pointer  to  Rect 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

Calls 

Function 

Where  Described 

InvertRect 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.13-59:  TruckTableHilite  Information. 


2.13.3.4.12  TruckDrawNumber 


TruckDrawNumber  fills  in  the  truck  number  field  in  the  specified  column  in  the  table  to 
display  to  the  user.  The  function  call  is  TruckDrawNumber(defn,  col,  row).  Table 
2.13-^  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

DevelopmentiSIMNET  :libmac; 
table.h 

col 

pointer  to 

FixT  ableColumnDefn 

Development:SIMNET  ilibmac: 
table.h 

row 

int 

Standard  C  type. 

293 


BBN  Systems  and  Technologies 


MCC  CSCI 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

truck 

register  pointer  to 
TruckDescriotor 

Development:SIMNET  :MCC; 
SCCiruck.h 

array  of  50  char 


Standard  C  t 


Function 


NumToString 


Move 


CharWidth 


Strinq  Width 


Calls 


Where  Described 


Standard  Binary  to  Decimal  C  onversion  Package  function  for 
Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


2.13.3.4.13 


Table  2.13-60:  TruckDrawNumber  Information. 
TruckDrawAssignment 


TnickDraw Assignment  fills  in  the  company  assignment  field  of  the  specified  column  in  the 
table  to  display  to  the  user.  The  function  call  is  TruckDrawAssignment(defn,  col,  row). 
Table  2.13-61  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


defn 


lEin 


pointer  to  FixTableFieldDefn 


pointer  to 

FixT  ableColumnDefn 


int 


Where  Tvoedef  Declared 


Development:SIMNET  ;libmac; 
table.h 


Development:SIMNET  :libmac: 
table.h 


Standard  C  t 


Variable 


truck 


IEI13 


Internal  Variables 


e 


register  pointer  to 
TruckDescriotor 


Point 


Where  Tvoedef  Declared 


Development:SIMNET  :MCC: 
SCC:truck.h 


DevelopmentiTHINK  C: 
Mac  #includes;MacTvDes.h 


Calls 


Function  Where  Described 


GetPen  Standard  Quickdraw  function  tor  Macintosh. 


MoveTo  Standard  Quickdraw  function  for  Macintosh. 


StrinqWidth  Standard  Quickdraw  function  for  Macintosh. 


Drawstring  Standard  Quickdraw  function  for  Macintosh. 


DrawChar  Standard  Quickdraw  function  for  Macintosh. 


Table  2.13-61:  TruckDrawAssignment  Information. 


2.13.3.4.14 


TruckDrawLocation 


TruckDrawLocation  fills  in  the  truck  location  field  for  the  specified  column  in  the  table  to 
display  to  the  user.  The  function  call  is  TruckDrawLocation(defn,  col,  row).  Table 
2.13-62  describes  the  parameters  used  and  functions  called  using  this  function. 
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Parameters 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

Development:SIMNET  :libmac; 
table.h 

col 

pointer  to 

FixT  ableColumnOefn 

Development;SIMNET  :libmac: 
table.h 

Variable 


tmck 


Internal  Variables 


e 


register  pointer  to 
TruckDescriptor 


Where  Tvpedef  Declared 


Developnnent:SIMNET  :MCC: 
SCC:truck.h 


Function 


DrawText 


Calls 


Where  Described 


Standard  Quickdraw  function  for  Macintosh. 


Table  2.13-62:  TruckDrawLocation  Information. 
2.13.3.4.15  TruckDrawFuelLoad 

TruckDrawFuelLoad  fills  in  the  truck  fuel  load  for  the  specified  column  in  the  table  to 
display  to  the  user.  The  function  call  is  TruckE>rawFuelLoad(defn,  col,  row).  Table 
2.13-63  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


defn 


Parameters 


Where  Typedef  Declared 


pointer  to  FixTableFieldDefn  Development:SIMNET :libmac: 

table.h 


pointer  to  Development:SIMNET:libmac; 

FixTableColumnDefn  table.h 


int  Standard  C  type. 


Variable 


truck 


Internal  Variables 


e 


register  pointer  to 
TruckDescriptor 


array  of  char 


Where  Typedef  Declared 


Development:SIMNET  :MCC: 
SCCitruck.h 


Standard  C  type. 


Calls 


Function  Where  Described 


NumToString  Standard  Binary  to  Decimal  Conversion  Package  function  for 

Macintosh. 


Move  Standard  Quickdraw  function  for  Macintosh. 


StringWidth  Standard  Quickdraw  function  for  Macintosh. 


Drawstring  Standard  Quickdraw  function  for  Macintosh. 


Table  2.13-63:  TruckDrawFuelLoad  Information. 


295 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.13.3.4.16  TruckDrawAmmoLoad 

TruckDrawAmmoLoad  fills  in  the  truck  ammo  load  field  for  the  Sfiecified  column  in  the 
table  to  display  to  the  user.  The  function  call  is  TruckDrawAmmoLx)ad(table,  column, 
row).  Table  2.13-64  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

table 

pointer  to  FixTableFieldDefn 

DevelopmentiSIMNET  :libmac; 
table. h 

column 

pointer  to 

FixT  ableColumnDefn 

DevelopmentiSIMNET  :libmac; 
table.h 

row 

int 

hi  F:  1  i'i 

Internal  Variables 

Variable 

Type 

truck 

pointer  to  TruckDescriptor 

Development  SIMNETiMCC: 
SCCrtruck.h 

rect 

Rect 

Development:THINK  C: 

Mac  #includes;MacTvpes.h 

1  Calls  1 

Function 

Where  Described 

FixTableRowRect 

See  Section  2.22.1.42.5. 

DisplavAmmoLoadSummarv 

See  Section  2.22.3.7.1. 

Table  2.13-64:  TruckDrawAmmoLoad  Information. 


2.13.3.5  truck. h 

Development:SIMNET:MCC:SCC:truck.h 

truck.h  is  the  header  file  associated  with  the  following  file,  truck.c  ,  in  Section  2.13.3.6. 
Table  2.13-65  describes  the  variables  used  by  truck.h. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

ammoTrucks 

extern  array  of  TruckDescriptor 

Development:SIMNET  :MCC: 
SCCiruck.h 

fuelTrucks 

extern  array  of  TruckDescriptor 

DevelopmentrSIMNET  ;MCC: 
SCC:truck.h 

maintTrucks 

extern  array  of  TruckDescriptor 

Development:SIMNET  :MCC; 
SCC;truck.h 

ammoTruckData 

extern  TmckTableData 

Development:SIMNET  :MCC: 
SCC;truck.h 

fuelTruckData 

extern  TruckTableData 

Development:SIMNET  :MCC: 
SCCiruck.h 

maintTruckData 

extern  TruckTableData 

Development:SIMNET  ;MCC: 
SCC:truck.h 

Table  2.13-65:  truck.h  Variable  Informaiton. 
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2.13.3.6  truck.c 

I>evelopment:SIMNET:MCC:SCC:truck.c 

truck.c  contains  various  functions  related  to  the  SCC  application’s  support  of  Combat 
vehicles.  Table  2.13-66  describes  the  variables  used  by  truck.c. 


Variables 


Variable 

Where  Tvoedef  Declared 

dmmoT  ruckEntryDialog 

extern  DialogDefn 

Development:SIMNET  :libmac; 
dialoQ.h 

fuelT  ruckEntryDialog 

extern  DialogDefn 

Development;SIMNET  ilibmac: 
dialoQ.h 

maintlruckEntryDialog 

extern  DialogDefn 

DevelopmentiSIMNET  :libmac; 
dialOQ.h 

ammoTrucks 

array  of 

numberBnM977Vehicles 

TruckDescriptor 

Development:SIMNET  :MCC; 
SCCiruck.h 

ammoTruckData 

TruckTableData 

Development;SIMNET  :MCC: 
SCC:truck.h 

fuelTrucks 

array  of 

numberBnM97Vehicles 

TruckDescriptor 

DevelopmentiSIMNET  ;MCC: 
SCCitruck.h 

fuelTruckData 

TruckTableData 

Development:SIMNET  ;MCC: 
SCCiruck.h 

maintTrucks 

array  of 

numberBnRepairVehicles 

TruckDescriptor 

DevelopmentiSIMNET  ;MCC; 
SCCitruck.h 

maintTruckData 

TruckTableData 

DevelopmentiSIMNET  :MCC: 
SCCitruck.h 

Table  2.13*66:  truck.c  Variable  Informaiton. 

2.13.3.6.1  UploadTruckParameters 

UploadTruckParameters  tells  the  host  a  truck’s  location  and  load,  truck  specifies  the  truck. 
The  function  call  is  UploadTruckParameters(truck).  Table  2.13-67  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


truck 


Parameters 


e 


register  pointer  to 
TruckDescriptor 


Where  Tvoedef  Declared 


Development:SIMNET  :MCC: 
SCC:truck.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

req 

SCCT  ruckInitRequest 

DevelopmentiSIMNET  iMCCi 
SCCiSCC.h 

Standard  C  type. 


Calls 

Function 

Where  Described 

ATPPut 

See  Section  2.22.1.3.3. 
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1  Called  Bv  1 

Function 

Where  Described 

T  ruckReconstComplete 

See  Section  2.13.5.3.3. 

UploadCSSParameters 

See  Section  2.13.3.1.6. 

Table  2.13-67:  UploadTruckParameters  Information. 
2.13.3.6.2  DownloadTruckParameters 

DownloadTruckParameters  obtains  from  the  host  information  about  a  truck’s  current 
location  and  load.  The  function  call  is  DownloadTruckParameters(truck).  Table  2.13-68 
describes  the  parameters  used,  errors  returned  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

truck 

register  pointer  to 
TruckDescriptor 

Development:SIMNET  :MCC: 
SCCiruck.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

req 

SCCT  ruckQuery  Request 

Development;SIMNET  ;MCC: 
SCCrSCC.h 

rsp 

SCCT  ruckQuery  Response 

Development:SIMNET  ;MCC; 
SCC:SCC.h 

i 

short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

ATPPut 

See  Section  2.22.1.3.3. 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

1  Called  Bv  1 

Function 

Where  Described 

TruckReconstStart 

See  Section  2.13.5.3.2. 

Table  2.13-68:  DownloadTruckParameters  Information. 


2.13.4  Simulation  of  Close  Air  and  Fire  Support 


2.13.4.1  cas.c 

Development:SIMNET:MCC:SCC:cas.c 

cas.c  implements  the  user  interface  for  initializing  the  close  air  support  simulation  and  for 
allotting  additional  sorties  for  close  air  support.  Table  2. 1 3-69  describes  the  variables  used 
by  cas.c. 


BBN  Systems  and  Technologies _ MCC  CSCI 


I  Internal  Variables  I 

Variable 

Where  Tvpedef  Declared 

daySortiesAllocated 

DateTimeRec 

Development:THINK  C; 

Mac  #includes:OSUtil.h 

totalSorties 

int 

Standard  C  type. 

preplannedSorties 

int 

Standard  C  type. 

addITotalSorties 

int 

Standard  C  type. 

addPreplannedSorties 

int 

Standard  C  type. 

initCASFields 

array  of  NumberFieldDefn 

Development:SIMNET  ilibmac: 
dialoQ.h 

initCASFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  rlibmac; 
dialog. h 

initCASDialog 

DialogNodeOefn 

Devetopment:SIMNET  ;libmac: 
sequence. h 

moreSortiesFields 

array  of  NumberFieldDefn 

DevelopmentrSIMNET  :libmac: 
dialog.h 

moreSortiesFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

moreSortiesDialog 

DialogNodeDefn 

DevelopmentiSIMNET  ilibmaci 
seguence.h 

Table  2.13*69:  cas.c  Variable  Information. 


2.13.4.1.1  LoadCannedCAS 


LoadCannedCAS  loads  canned  CAS  initialization  data.  The  function  call  is 
LoadCannedCAS ().  Table  2.13-70  describes  this  function. 


1  Called  By  1 

Function 

Where  Described 

LoadCannedData 

See  Section  2.13.8.15.2. 

Table  2.13*70:  LoadCannedCAS  Information. 

2.13.4.1.2  UploadCASParameters 

UploadCASParameters  upload  the  Close  Air  Support  parameters  to  the  host.  This  function 
is  only  compiled  if  VERSION  is  APPLETALK.  Otherwise,  it  is  a  dummy  function.The 
function  call  is  UploadCASParametersQ.  Table  2.13-71  describes  the  internal  variables 
used  and  functions  called  using  this  function. 

_  Internal  Variables  _ 

Variable  {Type  I  Where  Typedef  Declared 

req  SCCCASRequest  Development:SIMNET:MCC: 

SCC:SCC.h 


_ _ Calls _ 

Function  [Where  Described 

SetCursor _ Standard  Quickdraw  function  for  Macintosh. 

ATPPut_ See  Section  2.22.1 .3.3.  
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1  Called  By  I 

Function 

Where  Described 

InitCASEvent 

See  Section  2.13.4.1.3. 

MoreSortiesEvent 

See  Section  2.13.4.1.5. 

Table  2.13-71:  UploadCASParameters  Information. 


2.13.4.1.3  InitCASEvent 

InitCASEvent  is  called  when  a  button  in  the  initialize  CAS  dialog  is  pressed.  The  Inidalize 
CAS  dialog  permits  the  establishment  of  sortie  limits.  If  the  OK  button  was  pressed,  the 
CAS  parameters  are  uploaded .  The  item  number  of  the  button  pressed  is  returned.  The 
function  call  is  InitCASEvent(state,  itemNo).  Table  2.13-72  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac; 
dialog. h 

itemNo 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

0 

int 

do  nothing  upon  return 

itemNo 

int 

resource  id  of  button  hit 

1  Calls  1 

Function 

Where  Described 

CheckMandatorvFields 

See  Section  2.22.1.13.1. 

ShowCaution 

See  Section  2.22.1.4.1. 

UploadCASParameters 

See  Section  2.13.4.1.2. 

GetTime 

Standard  Ooeratinq  System  Utility  tunction  for  Macintosh. 

Table  2.13-72:  InitCASEvent  Information. 

2.13.4.1.4  MoreSortiesFetch 

MoreSortiesFetch  reads  the  current  values  of  the  sorties  limits  data  structures  into  the  More 
Sorties  dialog  fields  to  display  :o  the  user.  The  More  Sorties  dialog  permits  more  sorties  to 
be  allocated  to  CAS.  The  function  call  is  MoreSortiesFetch(state).  Table  2.13-73 
describes  the  parameters  used  and  functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialog. h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

now 

DateTimeRec 

Development  THINK  C; 

Mac  #includes:OSUtil.h 

str 

array  of  20  char 

Standard  C  type. 
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Calls 

Function 

Where  Described 

GetTime 

Standard  Operatina  System  Utility  function  for  Macintosh. 

SetText 

See  Section  2.22.1.11.8. 

Table  2.13-73:  MoreSortiesFetch  Information. 
2.13.4.1.5  MoreSortiesEvent 

MoreSortiesEvent  is  called  when  an  event  occurs  in  the  More  Sorties  dialog.  If  the  OK 
button  is  pressed,  the  CAS  parameters  are  uploaded,  and  the  total  number  of  sorties  is 
calculated.  The  item  number  of  the  button  pressed  is  returned.  The  function  caU  is 
MoreSortiesEvent(state,  itemNo).  Table  2.13-74  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

do  nothing  upon  return 

itemNo 

int 

resource  id  of  button  hit 

Calls 

Function 

Where  Described 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

ShowCaution 

See  Section  2.22.1.4.1. 

UploadCASParameters 

See  Section  2.13.4.1.2. 

Table  2.13-74;  MoreSortiesEvent  Information. 

2.13.4.2  fse.c 

Development:SIMNET:MCC:SCC:fse.c 

fse.c  implements  the  user  interface  for  initializing  and  resupplying  fire  support  elements 
simulate  by  the  MCC  system.  Table  2.13-75  describes  the  variables  used  by  fse.c. 
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Variables 

Variable 

Type 

Where  Typedef  Declared 

initMortarDialog 

extern  DialogNodeDefn 

DevelopmentiSIMNET  ilibmac; 
seouence.h 

fseConfirmDialog 

extern  DialogNodeDefn 

DevelopmentiSIMNET  ilibmac; 
seouence.h 

numberHowitzerBattenes 


nthBatte 


batteryOrdinals 


gunOata 


currentBatte 


initArtylLocField 


initArtyl  Fields 


initArtylFieldList 


initArtyl  Dialog 


initArty2LocFjeld 


initArty2Fields 


injtArty2Fieldust 


initArty2Dialog 


initArtySLocField 


initArtySFields 


initArtySFieldList 


InitArtySDialog 


initMortLocField 


initMortFields 


initMortFieldList 


initMortDialog 


fseConfirmFieldList 


fseConfirmDialog 


reconstBtryLocField 


extern  int 


short 


array  of  Str255 


array  of  maxNumberBatteries 
GunData 


short 


CoordinatesFieldDefn 


array  of  NumberFieidDefn 


pointer  to  array  of  FieldDef  n 


DialogNodeDefn 


CoordinatesFieldDefn 


array  of  NumberFieidDefn 


pointer  to  array  of  FieldDefn 


DialogNodeL  ^fn 


CoordinatesFieldDefn 


array  of  NumberFieidDefn 


pointer  to  array  of  FieldDefn 


DialogNodeDefn 


CoordinatesFieldDefn 


array  of  NumberFieidDefn 


pointer  to  array  of  FieldDefn 


DialogNodeDefn 


pointer  to  array  of  FieldDefn 


DialogNodeDefn 


CoordinatesFieldDefn 


Standard  C  t 


Standard  C  t 


Devetopment:THINK  C: 
Mac  #includes;MacTvDes.h 


Development:SlMNET.MCC. 

SCCrfse.c 


Standard  C  type. 


Development:SIMNET  ilibmac: 
dialoo.h 


Development:SIMNET  rlibmac: 
dialoo.h 


Development:SIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac; 
seouence.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac; 
dialoo.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac; 
seouence.h 


DevelopmentiSIMNET  ilibmac; 
dialoo.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac: 
seouence.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac: 
seouence.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


DevelopmentiSIMNET  ilibmac: 
seouence.h 


DevelopmentiSIMNET  ilibmac: 
dialoo.h 


(Table  2.13-75  is  continued  on  the  following  page.) 
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Variable 

Where  Tvpedef  Declared 

reconstBtryFieldList 

pointer  to  array  of  FieldDefn 

Development:SIMNET  :libmac; 
dialoa.h 

reconstBtry  Dialog 

DialogNodeDefn 

Development;SIMNET;libmac; 
sequence. h 

Table  2.13-75:  fse.c  Variable  Information. 

2.13.4.2.1  LoadCannedFSE 

LoadCannedFSE  loads  canned  FSE  data.  The  function  call  is  LoadCannedFSE().  Table 
2.13-76  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

StrinqToMapCoordinates 

See  Section  2.22.1.26.1. 

Called  By 

Function 

Where  Described 

LoadCannedData 

See  Section  2.13.8.15.2. 

Table  2.13-76:  LoadCannedFSE  Information. 

2.13.4.2.2  InitArtyFetch 

InitArtyFetch  reads  the  current  values  of  the  artillery  data  structures  into  the  dialog  fields  to 
display  to  the  user.  The  Initialize  Artillery  dialog  accepts  positions  and  supplies  for 
batteries.  There  may  be  up  to  three  Init  Arty  didogs.  The  function  call  is 
InitArtyFetch(state).  Table  2.13-77  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  DialogState 

Development:SIMNET  ilibmac: 
dialog.h 

Calls 

Function 

Where  Described 

ParamText 

Standard  Dialog  Manager  function  for  Macintosh. 

Table  2.13-77:  InitArtyFetch  Information. 
2.13.4.2.3  InitArtyEvent 


InitArtyEvent  is  called  when  an  event  occurs  in  the  Init  Arty  dialog.  It  determines  whether 
the  data  entered  is  valid.  It  throws  the  current  dialog  away  and  goes  to  the  main  screen.  It 
returns  the  item  number  of  the  button  pressed.  The  function  call  is  InitArtyEvent(dialog, 
itemNo).  Table  2.13-78  describes  the  parameters  used  and  functions  called  using  this 
function. 
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1  Parameters  | 

Parameter 

Where  Yypedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialoq.h 

itemNo 

int 

Standard  C  type. 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

int 

so  nothing  upon  return 

itemNo 

int 

resource  id  of  the  button  hit 

1  Calls  1 

Function 

Where  Described 

CheckMandatorvFields 

See  Section  2.22.1.13.1. 

Table  2.13-78:  InitArtyEvent  Information. 


2.13.4.2.4  InitArtyBranch 

InitArtyBranch  determines  the  next  dialog  to  pop  up  when  an  item  from  a  list  is  selected.  It 
checks  the  type  of  item  selected  and  brings  up  the  next  dialog,  depending  on  the  item  type. 
It  returns  a  handle  to  the  next  dialog  to  pop  up.  The  function  call  is  InitArtyBranch(state). 
Table  2.13-79  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

state 

pointer  to  DialogSeqState 

DevelopmentrSIMNET  :libmac; 
sequence. h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

&initMortDialog 

pointer  to  DialogNodeDefn 

handle  of  the  Mortors  Dialog 

&i  nit  Arty2  Dialog 

pointer  to  DialogNodeDefn 

handle  of  the  second  Artillery 
Dialog 

&initArty3  Dialog 

pointer  to  DialogNodeDefn 

handle  of  the  third  Artillery 
Dialog 

Table  2.13-79:  InitArtyBranch  Information. 


2.13.4.2.5  UploadFSEParameters 

UploadFSEParameters  uploads  the  FSE  initialization  parameters.  This  function  will  only 
compile  if  VERSION  is  APPLETALK.  Otherwise,  it  is  a  dummy  function.  The  function 
call  is  UploadFSEParametersO.  Table  2. 1 3-80  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  internal  Variables  1 

Variable 

Where  Typedef  Declared 

req 

SCCFSERequest 

Development:SIMNET;MCC: 

SCC:SCC.h 

i 

short 

Standard  C  type. 

J _ 

short 

Standard  C  type. 
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Calls 

Function 

Where  Described 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

ATPPut 

See  Section  2.22.1.3.3. 

Called  Bv 

Function 

Where  Described 

FSEConfirmEvent 

See  Section  2.13.4.2.7. 

Table  2.13-80:  UploadFSEParameters  Information. 
2.13.4.2.6  FSEConfirmFetch 


FSEConfirmFetch  reads  the  FSE  confirmation  choices  into  the  FSE  Confirm  dialog  fields 
to  display  to  the  user.  The  function  call  is  FSEConfirmFetch(dialog).  Table  2. 13-81 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Devetopment:SIMNET  rlibmac: 
dialog. h 

Calls 

Function 

Where  Described 

ParamText 

Standard  Dialog  Manager  function  for  Macintosh. 

SetWTitle 

Standard  Window  Manager  function  for  Macintosh. 

Table  2.13-81:  FSEConfirmFetch  Information. 

2.13.4.2.7  FSEConfirmEvent 

FSEConfirmEvent  is  called  when  an  event  occurs  in  the  FSE  Confirm  dialog.  The  validity 
of  the  data  is  checked.  If  the  OK  button  was  pressed,  the  FSE  parameters  are  uploaded, 
and  the  guns  are  added  to  the  table  of  displaceable  entities.  It  throws  the  current  dialog 
away  and  goes  to  the  next  dialog  in  the  sequence.  It  returns  the  item  number  of  the  button 
pressed.  The  function  call  is  FSEConfirmJEvent(dialog,  itemNo).  Table  2.13-82  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

dtindex 

int 

Standard  C  type. 

1  1 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

do  nothing  upon  return 

itemNo 

int 

resource  id  of  button  hit 

Calls 

Function 

Where  Described 

UploadFSEPara  meters 

See  Section  2.13.4.2.5. 

DialoqSeqNext 

See  Section  2.22.1.39.4. 

Table  2.13>82:  FSEConfirmEvent  Information. 

2.13.4.2.8  UploadBtryParameters 

UploadBtryParameters  uploads  new  battery  parameters.  This  function  will  only  compile  if 
VERSION  is  APPLETALK.  Otherwise,  it  is  a  dummy  function.  The  function  call  is 
UploadBtryParameters(battery).  Table  2.13-83  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

battery 

reqister  int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

req 

SCCArtyReconstRequest 

Development:SIMNET  :MCC: 
SCC.SCC.h 

i 

short 

Standard  C  type. 

Calls 

Function 

Where  Described 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

ATPPut 

See  Section  2.22.1.3.3. 

Called  By 

Function 

Where  Described 

BtryReconstEvent 

See  Section  2.13.4.2.11. 

Table  2.13-83:  UploadBtryParameters  Information. 


2.13.4.2.9  DownloadBtry Parameters 

DownloadBtryParameters  downloads  battery  parameters  from  host.  This  function  will 
only  compile  if  VERSION  is  APPLETALK.  Otherwise,  it  is  a  dummy  function.  The 
function  call  is  DownloadBtryParameters(battery).  Table  2.13-84  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

battery 

register  int 

Standard  C  type. 

1  1 
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1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

req 

SCCArtyQueryRequest 

Development:SIMNET  :MCC: 
SCC:SCC.h 

rsp 

SCCArtyQueryResponse 

DeveiopmentiSIMNET  :MCC: 
SCCrSCC.h 

i 

short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

ATPPut 

See  Section  2.22.1.3.3. 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

1  Called  Bv  1 

Function 

Where  Described 

ShowBtryReconstDialoq 

See  Section  2.13.4.2.10. 

Table  2. 13-84:  DownloadBtryParameters  Information. 
2.13.4.2.10  ShowBtryReconstDialog 

ShowBtryReconstDialog  determines  which  battery  is  being  reconstituted,  downloads 
information  about  the  battery,  and  puts  up  the  dialog  allowing  the  reconstitution  of  mortars. 
The  function  call  is  ShowBtryReconstDialog(battery).  Table  2.13-85  describes  the 
parameters  used  and  functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

battery 

reqister  int 

Standard  C  type. 

Calls 

Function 

Where  Described 

DownloadBtryParameters 

See  Section  2.13.4.2.9. 

DialoqSeqNext 

See  Section  2.22.1.39.4. 

Called  By 

Function 

Where  Described 

ReconstEvent 

See  Section  2.13.5.3.7. 

Table  2.13-85:  ShowBtryReconstDialog  Information. 

2.13.4.2.11  BtryReconstEvent 

BtryReconstEvent  is  called  when  a  button  in  the  Battery  Reconstitute  dialog  is  pressed.  It 
determines  whether  the  data  entered  is  valid.  If  the  OK  button  was  pressed,  the  battery 
parameters  are  uploaded.  If  the  Cancel  button  was  pressed,  the  current  dialog  is  thrown 
away  and  the  overview  screen  is  put  up.  The  item  number  of  the  button  pressed  is 
returned.  The  function  call  is  BtryReconstEvent(dialog,  itemNo).  Table  2.13-86  describes 
the  parameters  used  and  functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development;SIMNET;libmac; 

dialoq.h 

itemNo 

int 

Standard  C  type. 

1  internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

dtindex 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

do  nothing  upon  return 

okBItem 

int 

resource  id  of  OK  button 

itemNo 

int 

resource  id  of  button  hit 

1  Calls  1 

Function 

yyhere  Described 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

UploadBtrvParameters 

See  Section  2.13.4.2.8. 

Table  2.13-86:  BtryReconstEvent  Information. 

2.13.4.2.12  GetGunAzimuth 

GetGunAzimuth  returns  the  gun  azimuth  of  a  battery.  The  function  call  is 
GetGunAzimuth(battery).  Table  2.13-87  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

battery 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

gunData[battery]. azimuth 

int 

Gun  azimuth  of  a  battery. 

Called  By 

Function 

Where  Described 

NetworkArrived 

See  Section  2.13.8.10.22. 

Table  2.13-87: 


GetGunAzimuth  Information. 
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2.13.4.3  cew.h 

Development:SIMNET:MCC:SCC:cew.h 

cew.h  is  the  header  file  associated  with  cew.c,  in  Section  2.13.4.4.  Table  2.13-88 
describes  the  variables  used  by  cew.h. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

cewAssetNumber 

extern  short 

Standard  C  type. 

cewAssets 

extern  array  of 

maxCEW  Assets  CEWVehicle 

DevelcpmentiSIMNET  ;MCC: 
SCC:cew.h 

cewReconstAsset 

extern  short 

Standard  C  type. 

cewPlatoonVehicleName 

extern  array  of  20  char 

Standard  C  type. 

cewGEMSSName 

extern  array  of  20  char 

Standard  C  type. 

cewM57Name 

extern  array  of  20  char 

Standard  C  type. 

cewLineChargeName 

extern  array  of  20  char 

Table  2.13-88:  cew.h  Variable  Information. 

2.13.4.4  cew.c 

Development:SIMNET:MCC:SCC:cew.c 

cew.c  implements  the  Combat  Engineering  resource  allocation.  Table  2.13-89  describes 
the  variables  used  by  cew.c. 
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1  Variables  1 

Variable 

Where  Typedef  Declared 

initOverview  Dialog 

extern  DialogNodeDefn 

Development:SIMNET  :Kbmac: 
sequence,  h 

cewAllocDialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac; 
sequence. h 

cewPlaceDialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac: 
sequence. h 

cewConfirmDialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac: 
sequence. h 

cewDefaultLocation 

MapCoordinates 

Development:SIMNET  ilibmac; 
mao.h 

cewPlatoonNumber 

short 

Standard  C  type. 

cewGEMSSNun^er 

short 

Standard  C  type. 

cewLineCharger 

short 

Standard  C  type. 

cewM57Number 

short 

Standard  C  type. 

cewAssetNumber 

short 

Standard  C  type. 

cewReconstAsset 

short 

Standard  C  type. 

cewPlatoonVehicleName 

array  of  20  char 

Standard  C  type. 

cewGEMSSName 

array  of  20  char 

Standard  C  type. 

cewM57Name 

array  of  20  char 

Standard  C  type. 

cewLineCharaerName 

array  of  20  char 

Standard  C  type. 

cewAssets 

array  of  maxCEWAssets 
CEWVehicle 

Development:SIMNET  :MCC; 
SCC:ce\v.h 

cewAllocFields 

array  of  NumberFieldDefn 

DeyelopmentiSIMNET  :libmac; 
dialog. h 

cewDefaultLocationField 

Coordi  nate  sFieldDef  n 

Deyelopment:SIMNET  :libmac; 
dialoq.h 

cewAllocFieldList 

pointer  to  array  of  FieldDefn 

Deyelopment:SIMNET  :libmac: 
dialoq.h 

cewAllocDialog 

DialogNodeDefn 

Development;SIMNET  :libmac; 
sequence. h 

cewConfirmFieldList 

pointer  to  array  of  FieldDefn 

DeyelopmentiSIMNET  ilibmac: 
dialoq.h 

cewConfirmDialog 

DialogNodeDefn 

DeyelopmentiSIMNET  ilibmac: 
sequence. h 

cewReconstLocation 

MapCoordinates 

DevelopmentiSIMNET  ilibmac: 
map.h 

cewReconstLocationField 

Coordi  natesFieldDefn 

DeyelopmentiSIMNET  liibmac: 
dialoq.h 

cewReconstFieldList 

pointer  to  array  of  FieldDefn 

DeyelopmentiSIMNET  ilibmac: 
dialoq.h 

cewReconstDailog 

DialogNodeDefn 

DevelopmentiSIMNETilibmac: 
sequence. h 

Table  2.13-89:  cew.c  Variable  Information. 
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2.13.4.4.1  LoadDefaultCEWParameters 

LoadDefaultCEWParameters  loads  in  default  CEW  parameters.  The  function  call  is 
LoadDefaultCEWParameters().  Table  2. 1 3-90  describes  the  functions  called  using  this 
function. 


1  Calls  1 

Function 

Where  Described 

Stri  nqT  oM  apCoordi  nates 

See  Section  2.22.1.26.1. 

Called  By 

Function 

Where  Described 

CEWAllocFetch 

See  Section  2.13.4.4.2. 

Table  2.13-90:  LoadDefaultCEWParameters  Information. 
2.13.4.4.2  CEWAllocFetch 

CEWAUocFetch  reads  the  current  values  of  the  CEW  resource  allocations  into  the  dialog 
fields  to  display  to  the  user.  The  function  call  is  CEWAllocFetch(state).  Table  2.13-100 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

Calls 

Function 

Where  Described 

LoadDefaultCEWParameters 

See  Section  2.13.4.4.1. 

SellText 

Standard  Dialog  Manager  function  for  Macintosh. 

Table  2.13-100:  CEWAllocFetch  Information. 

2.13.4.4.3  CEWAIIocEvent 

CEWAllocEvent  is  called  when  a  button  in  the  CEW  Allocation  dialog  is  pressed.  If  the 
Next  button  was  pressed,  the  numbers  are  set,  the  assets  are  set  up,  and  the  gemss,  M57 
and  live  charges  are  initialized.  The  function  call  is  CEWAllocEvent(dialog,  itemNo). 
Table  2.13-101  describes  the  parameters  used  and  functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  rlibmac: 
dialog. h 

itemNo 

short 

Standard  C  type. 

I  I 

BBN  Systems  and  Technologies 


MCC  CSCI 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

counter 

short 

Standard  C  type. 

asset 

short 

Standard  C  type. 

Dl 

short 

Standard  C  type. 

£2 

short 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

short 

do  nothing  upon  return 

itemNo 

short 

resource  id  of  button  hit 

1  Calls  1 

Function 

Where  Described 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

Table  2.13-101:  CEWAIIocEvent  Information. 

2.13.4.4.4  UploadCEWParameters 

UploadCEWParameters  uploads  CEW  parameter  information  to  the  host.  The  function  call 
is  UploadCEWParameters().  Table  2.13-102  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

double 

Standard  C  type. 

asset 

short 

Standard  C  type. 

ereq 

SCCCEWStartRequest 

Development;SIMNET  :MCC: 
SCC:SCC.h 

req 

SCCCEWinitRequest 

Development:SIMNET  :MCC: 
SCC:SCC.h 

1  Calls  1 

Function 

Where  Described 

ATPPut 

See  Section  2.22.1.3.3. 

1  Called  By  1 

Function 

Where  Described 

CEWConfirmFetch 

See  Section  2.13.4.4.6. 

Table  2.13-102: 


UploadCEWParameters  Information. 
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2.13.4.4.5  CEWConfirmFetch 


CEWConfirmFetch  reads  the  CEW  confirmation  choices  into  the  dialog  fields  to  display  to 
the  user.  The  function  call  is  CEWConfirmFetch(dialog).  Table  2.13-103  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  tc  DialogState 

Development:SIMNET  :libmac: 
dialoq.h 

1  Calls  1 

Function 

Where  Described 

ParamText 

Standard  Dialog  Manager  function  for  Macintosh. 

SetWTitle 

Standard  Window  Manager  function  for  Macintosh. 

Table  2.13-103:  CEWConfirmFetch  Information. 


2.13.4.4.6  CEWConfirmEvent 


CEWConfirmEvent  is  called  when  a  button  in  the  CEW  confirm  dialog  is  pressed.  If  the 
OK  button  was  pressed,  the  CEW  paramters  are  uploaded  to  the  host ,  and  the  Combat 
Engineering  option  is  turned  off  in  the  overview  screen.  The  function  call  is 
CEWConfirmEvent(diualog,  itemNo).  Table  2.13-104  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  :libmac; 
dialog. h 

itemNo 

short 

Standard  C  tvpe. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

ds 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialog. h 

Return  Values 

Return  Value 

Type 

Meaning 

cancelBItem 

short 

resource  id  of  the  Cancel 
button 

itemNo 

short 

resource  id  of  the  OK  button 

Calls 

Function 

Where  Described 

ShowWait 

See  Section  2.22.1.45.1. 

UploadCEWParameters 

See  Section  2.13.4.4.4. 

Throw  Wait 

See  Section  2.22.1.45.2. 

Table  2.13-104:  CEWConfirmEvent  Information. 
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2.13.4.4.7  CEWReconstFetch 

CEWReconstFetch  is  called  in  order  to  fill  in  the  name  of  the  vehicle  selected  and  its  current 
location  before  the  CEW  Reconstitute  dialog  is  put  up  on  the  screen.  The  function  call  is 
CEWReconstFetch(state).  Table  2.13-105  describes  the  parameters  used  and  functions 
called  usmg  this  function. 


Parameter 


state 


Variable 


buffer 


Ipt 


Parameters 


pointer  to  DialogState 


IEI73 


Internal  Variables 


e 


array  of  100  char 


LongPt 


Where  Tvoedef  Declared 


DevelopmentiSIMNET  :libmac: 
dialoo.h 


Where  Typedef  Declared 


Standard  C  type. 


DevetopmentiSIMNET  :libmac: 
lonoDt.h 


Standard  C  type. 


Function 


PointToMaoCoordinates 


ParamText 


Calls 


Where  Described 


See  Section  2.22.1.26.2. 


Standard  Dialoq  Manaaer  function  for  Macintosh. 


Table  2.13-105:  CEWReconstFetch  Information. 

2.13.4.4.8  CEWReconstEvent 

CEWReconstEvent  is  called  when  an  event  occurs  in  the  CEW  Reconstitute  dialog.  The 
validity  of  the  data  is  checked.  If  the  Next  button  was  pressed,  it  gets  the  location  and  tells 
the  host  to  reconstitute  the  asset.  The  item  number  of  ^e  button  pressed  is  returned.  The 
function  call  is  CEWReconstEvent(diaIog,  itemNo).  Table  2.13-106  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialog. h 

itemNo 

short 

Standard  C  type. 

Variable 


req 


Internal  Variables 


e 


SCCCEWReconstRequest 


Where  Typedef  Declared 


Development:SIMNET;MCC: 

SCC:SCC.h 


Return  Values 


Return  Value 


0 


nextBItem 


itemNo 


Type 


short 


short 


short 


Meaning _ 


do  nothing  upon  return 


CEW  cancel  button  was  hit 


resource  id  of  the  button  hit 
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1  Calls  1 

Function 

Where  Described 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

ATPPut 

See  Section  2.22.1.3.3. 

Table  2.13-106:  CEWReconstEvent  Information. 


2.13.4.4.9  UpdateCE W AssetLocation 

UpdateCEWAssetLocation  gets  the  latest  location  of  asset  (the  CEW  asset)  and  sets  the 
location  field  in  the  dialog.  The  function  call  is  UpdateCEWAssetLocation(asset).  Table 
2.13-107  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


asset 


Variable 


req 


counter 


Ipt 


IEI73 


Internal  Variables 


SCCCEWQueryRequest 


SCCCEWQueryResponse 


short 


LongPt 


Where  Tvoedef  Declared 


Standard  C  type. 


Where  Typedef  Declared 


Development:SIMNET  :MCC: 
SCC:SCC.h 


Development:SIMNET:MCC: 

SCC:SCC.h 


Standard  C  tvoe. 


Development:SIMNET  :libmac; 
lonoDt.h 


Standard  C  tvoe. 


Function 


SetCursor 


ATPPut 


PointToMapCoordinates 


ShowCaution 


Calls 


Where  Described 


Standard  Quickdraw  function  for  Macintosh. 


See  Section  2.22.1.3.3. 


See  Section  2.22.1.26.2. 


See  Section  2.22.1.4.1. 


Function 


ShowCEWReconstDialo 


Called  B 


Where  Described 


See  Section  2.13.4.4.10. 


Table  2.13-107:  UpdateCEWAssetLocation  Information. 
2.13.4.4.10  ShowCEWReconstDialog 


ShowCEWReconstDialog  puts  up  the  CEW  Reconstitute  dialog.  The  function  call  is 
ShowCEWReconstDialog(asset).  Table  2.13-108  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

asset 

short 

Standard  C  type. 

1  -  ] 
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1  Calls  1 

Function 

Where  Described 

UpdateCEWAssetLocation 

See  Section  2.13.4.4.9. 

DialogSeqNext 

See  Section  2.22.1.39.4. 

Called  By 

Function 

Where  Described 

ReconstEvent 

See  Section  2.13.5.3.7. 

Table  2.13-108:  ShowCEWReconstDialog  Information. 


2.13.5  Reconstitution  of  Simulated  Vehicles 


2.13.5.1  reconscr.h 

Development:SIMNET:MCC:SCC:reconscr.h 

reconscr.h  is  the  header  file  associated  with  the  following  two  files,  reconscr.c  and 
reconsct.c.  This  file  contains  definitions  needed  to  implement  scrolling  tables  in  the 
reconstitution  dialog.  Table  2.13  109  describes  the  variables  used  by  reconscr.h. 


9  Variables  I 

Variable 

iType _ 1 

Where  Typedef  Declared 

reconstEntitvNames 

rmspmmrmtmsm 

Standard  C  type. 

Table  2.13-109:  reconscr.h  Variable  Information. 


2.13.5.2  reconscr.c 

Development:SlMNET:MCC:SCC:reconscr.c 

reconscr.c  implements  a  scrolling  table  of  elements  that  may  be  reconstituted  by  the 
BattleMaster.  Table  2.13-1 10  describes  the  variables  used  by  reconscr.c. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

reconstEntitvNames 

pointer  to  array  of  char 

Standard  C  type. 

Table  2.13-110:  reconscr.c  Variable  Information. 

2.13.5.2.1  NewReconstEleinent 

NewReconstElement  allocates  memory  for  a  new  element  in  the  reconstitution  table,  and 
sets  up  fields.  The  function  call  is  NewReconsiElemeni(key).  Table  2. i3-l  1 1  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

key 

short 

Standard  C  type 

1  1 
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Variable 


element 


Internal  Variables 


register 

ReconstElementHandle 


Where  Tvoedef  Declared 


Development:SIMNET  :MCC; 
SCCrreconscr.h 


Return  Value 


element 


Return  Values 


e 


ReconstElementHandle 


Meanin 


Handle  to  the  data  structure 
describing  the  entry  that  was 
lust  created. 


Calls 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manager  function  for  Macintosh. 

Called  B 


Function 

Where  Described 

ReconstFetch 

See  Section  2.13.5.3.4. 

Table  2.13-111:  NewReconstElement  Information. 

2.13.5.2.2  NewReconstVehicle 

NewReconstVehicle  allocates  memory  for  a  new  vehicle  entry  in  the  reconstitution  table, 
and  sets  up  fields.  The  function  call  is  NewReconstVehicle(type,  vehicleNumber).  Table 
2.13-1 12  describes  the  parameters  used  and  functions  called  using  this  function. 


BBN  Systems  and  Technologies 


MCC  CSCI 


1  Called  Bv  1 

Function 

Where  Described 

ReconstElementSelect 

See  Section  2.13.S.3.5. 

Table  2.13-112:  NewReconstVehicIe  Information. 
2.13.5.2.3  DrawReconstElement 

DrawReconstElement  fills  in  element  fields  of  the  specified  column  in  the  reconstitution 
table  to  display  to  the  user.  The  function  call  is  DrawReconstElement(defn,  col,  entry, 
box).  Table  2.13-1 13  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

defn 

pointer  to 

Scroll!  ableFieldDef  n 

DevelopmentiSIMNET  :libmac; 
scroll. h 

col 

pointer  to 

ScrollTableColumnDefn 

Development;SIMNET  :libmac: 
scroll.h 

entry 

ScrollTableEntryHandle 

Development;SIMNET  ilibmac: 
scroll.h 

box 

pointer  to  Red 

DevelopmentiTHINK  C; 

Mac  #includes:MacTvpes.h 

Calls 

Function 

Where  Described 

Move 

Standard  Quickdraw  function  for  Macintosh. 

DrawSlrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.13-113:  DrawReconstElement  Information. 

2.13.5.2.4  DrawReconstVehicle 

DrawReconstVehicle  fills  in  vehicle  fields  of  the  specified  column  in  the  reconstitution  table 
to  display  to  the  user.  The  function  call  is  DrawReconstVehicle(defn,  col,  entry,  box). 
Table  2. 13-1 14  describes  the  parameters  used,  errors  returned  and  functions  called  using 
this  function. 


1  Parameters  | 

Parameter 

Where  !ypedef  Declared 

defn 

pointer  to 

Scroll!  ableFieldDef  n 

Development:SIMNE!  :libmac: 
scroll.h 

col 

pointer  to 

Scroll!  ableColumnDef  n 

Development  :SIMNE!  :libmac: 
scroll.h 

entry 

Scroll!  ableEntryHandle 

Development  :SIMNE!  ilibmac: 
scroll.h 

box 

pointer  to  Red 

Development;!HINK  C; 

Mac  #includes:Mac!vpes.h 

1 
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1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

Sim 

register  pointer  to 
SimDescriptor 

DevelopmentiSIMNET  :MCC: 
libsim:libsim.h 

vehicle 

register 

ReconstVehicleHandle 

Development:SIMNET  :MCC; 
SCC:reconscr.h 

cStr 

array  of  30  char 

Standard  C  type. 

oStr 

array  of  30  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

Move 

Standard  Quickdraw  function  for  Macintosh. 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.13-114:  DrawReconstVehicle  Information. 


2.13.5.3  reconst. c 

Development:SIMNET:MCC:  SCC:reconst.c 


reconst.c  implements  a  scrolling  table  of  elements  that  may  be  reconstituted  by  the 
BattleMaster.  Table  2.13-1 15  describes  the  variables  used  by  reconstc. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

reconstTOC  Dialog 

extern  DialogNodeDefn 

DevelopmentiSIMNET  ilibmac; 
sequence. h 

reconst  ALOC  Dialog 

extern  DialogNodeDefn 

Development:SIMNET  ilibmac: 
sequence. h 

reconstVehicleColumn 

extern 

ScrollTableColumnDefn 

DevelopmentiSIMNET  :libmac. 
scroll.h 

numberHowitzerBatteries 

extern  int 

Standard  C  type. 

selectedVehicle 

short 

Standard  C  type. 

selectedVehicleType 

short 

Standard  C  type. 

reconst  Selection 

short 

Standard  C  type. 

reconstElementTable  Field 

extern  ScrollTableFieldDefn 

Development:SIMNET.Iibmac: 

scroll.h 

reconstVehicleTableField 

extern  ScrollTableFieldDefn 

DevelopmentiSIMNET  :libmac: 
scroll.h 

vehicleT  ableHeadinq 

array  of  30  char 

Standard  C  type. 

reconstOverviewField 

PushButtonFieldDefn 

DevelopmentiSIMNET  ilibmac; 
dialoq.h 

reconstElementColumn 

ScrollTableColumnDefn 

DevelopmentiSIMNETilibmac; 

scroll.h 

reconstVehicleColumn 

ScrollT  ableColumnDef  n 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

reconstElementTableField 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

reconstVehicleTableField 

ScrollT  ableFieldDef  n 

DevelopmentiSIMNET  ilibmac; 
scroll.h 

reconstFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialoq.h 

reconst  Dialog 

DialogNodeDefn 

DevelopmentiSIMNET  ilibmac: 
sequence. h 

Table  2.13-115:  reconst.c  Variable  Information. 
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2.13.5.3.1  SimReconstComplete 


SimReconstComplete  is  called  to  bring  up  the  BatterMaster’s  overview  dialog.  The 
function  call  is  SimReconstComplete(sim,  success).  Table  2.13-1 16  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

sim 

pointer  to  SimDescriptor 

DevelopmentiSIMNET  ;MCC; 
libsimilibsim.h 

success 

int 

Standard  C  type. 

I  Calls  1 

Function 

Where  Described 

DisposeScrollTable 

See  Section  2.22.1.30.2. 

DialogSeqNext 

See  Section  2.22.1.39.4. 

Table  2.13-116:  SimReconstComplete  Information. 
2.13.5.3.2  TruckReconstStart 


TruckReconstStart  downloads  the  latest  status  of  truck  and  puts  up  the  truck  dialog  in  order 
to  modify  the  status.  The  function  call  is  TruckReconstStart(truck).  Table  2. 13-1 17 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

truck 

pointer  to  TruckDescriptor 

Development.SIMNET  :MCC: 
SCC:truck.h 

Calls 

Function 

Where  Described 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

Download!  mckParameters 

See  Section  2.13.3.6.2. 

ShowTruckDialog 

See  Section  2.13.3.3.1. 

Called  By 

Function 

Where  Described 

ReconstEvent 

See  Section  2.13.5.3.7. 

Table  2.13-117:  TruckReconstStart  Information. 
2.13.5.3.3  TruckReconstComplete 

TruckReconstComplete  is  called  to  check  the  truck  reconstitution  for  successful 
completion.  The  reconst  dialog  is  taken  down  and  the  BattleMaster's  overview  dialog  is 
put  up.  The  function  call  is  TruckReconstComplete(truck,  success).  Table  2.13-1 18 
describes  the  parameters  u.sed  and  functions  called  using  this  function. 


320 


BBN  Systems  and  Technologies 


MCC  CSCI 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

truck 

pointer  to  TruckOescriptor 

Development:SIMNET  ;MCC; 
SCCiruck.h 

success 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

Upload!  ruckParameters 

See  Section  2.13.3.6.1. 

ThrowDialoa 

See  Section  2.22.1.11.3. 

DisposeScrollTable 

See  Section  2.22.1.30.2. 

DialoqSeqNext 

See  Section  2.22.1.39.4. 

Table  2.13-118:  TruckReconstComplete  Information. 


2.13.5.3.4  ReconstFetch 


ReconstFetch  builds  the  recontst  element  table  into  dialog  fields  to  display  to  the  user.  The 
function  call  is  ReconstFetch(dialog).  Table  2.13-1 19  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  ;libmac; 
dialoq.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

element 

register 

ReconstElementHandle 

Development  iSIMNET  :MCC; 
SCC:reconscr.h 

vehicle 

register 

Recons»VehicleHandle 

Development:SIMNET  :MCC: 
SCC:reconscr.h 

sim 

register  pointer  to 
SimDescriptor 

Development.SIMNET  :MCC: 
libsim:libsim.h 

i 

reqister  int 

Standard  C  tvpe. 

first 

int 

Standard  C  type. 

t1 

ScrollTableEntryHandle 

Development:SIMNET  :libmac: 
scroll. h 

t2 

ScrollTableEntryHandle 

Development:SIMNET  ;libmac: 
scroll. h 

1  Calls  1 

Function 

Where  Described 

NewReconstElement 

See  Section  2.13.5.2.1. 

InstallScrollTableEntrv 

See  Section  2.22.1.21.1. 

Reconst  ElementSelect 

See  Section  2.13.5.3.5. 

ScrollTableEntrvToRow 

See  Section  2.22.1.34.2. 

Table  2.13-119:  ReconstFetch  Information. 
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2.13.5.3.5  ReconstElementSelect 

ReconstElementSelect  is  called  to  build  the  roionst  vehicle  table  for  the  selected  element  in 
the  reconst  element  table.  It  checks  for  validity  of  the  selection  and  brings  up  the  next 
dialog  describing  the  selection.  When  this  function  is  called  box  mdtheEvent  may  be  null. 
The  function  call  is  ReconstElementSelectfdefn,  row,  box,  theEvent).  Table  2.13-120 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


defn 


theEvent 


IE213 


Parameters 


e 


pointer  to 

ScrollTableFieldDefn 


int 


pointer  to  Rect 


pointer  to  EventRecord 


Where  Tvpedef  Declared 


DevelopmentiSIMNET  :libmac: 
scroll,  h 


Standard  C  t 


Development:THINK  C: 
Mac  #includes:MacTvpes.h 


Devetopment:THINK  C: 
Mac  #includes:EventMqr.h 


Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

element 

ReconstElementHandle 

Development:SIMNET  :MCC: 
SCCireconscr.h 

entry 

register 

ScrollTableEntryHandle 

Development:SIMNET  :libmac: 
scroll. h 

t1 

register 

ScrollTableEntryHandle 

Development:SIMNET  ilibmac: 
scroll.h 

t2 

register 

ScrollTableEntryHandle 

Development:SIMNET  ilibmac; 
scroll.h 

vehicle 


first 


savePort 


reqister  int 


register  pointer  to 
SimDescriptor 


ReconstVehicleHandle 


int 


GrafPtr 


Standard  C  type. 


Development:SIMNET  :MCC: 
libsimriibsim.h 


DevelopmentiSIMNET  :MCC; 
SCC:reconscr.h 


Standard  C  type. 


DevelopmentTHINK  C; 
Mac  #includes:Quickdraw.h 


Function 


SetScrollTableSelection 


DisposHandle 


SetCtIMax 


GetPort 


SetPort 


InvalRect 


NewReconstVehicle 


Calls 


Where  Described 


See  Section  2.22.1.34.1. 


See  Section  2.22.1.37.2. 


Standard  Memory  Manaqer  function  for  Macintosh. 


Standard  Control  Manaqer  function  tor  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Window  Manaqer  function  for  Macintosh. 


See  Section  2.13.5.2.2. 


See  Section  2.22.1.21.1. 


Function 


ReconstFetch 


Called  B 


Where  Described 


See  Section  2.13.5.3.4. 


Table  2.13-120:  ReconstElementSelect  Information. 
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2.13.5.3.6  ReconstVehicleSelect 

ReconstVehicleSelect  is  called  when  an  entry  in  the  reconst  vehicle  table  is  selected.  It 
checks  for  validity  of  selection  and  brings  up  the  next  dialog  describing  the  selection.  The 
function  call  is  ReconstVehicleSelect(defn,  row,  box,  theEvent).  Table  2.13-121  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development:SIMNET  :libmac: 
scroll. h 

row 

int 

Standard  C  type. 

box 

pointer  to  Rect 

DevelopmentTHINK  C; 

Mac  #includes:MacTypes.h 

theEvent 

pointer  to  EventRecord 

DevelopmentrTHINK  C; 

Mac  #includes:EventMqr.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

entry 

register 

ScrollTableEntrvHandle 

DevelopmentrSIMNET  ;libmac; 
scroll. h 

1  Calls  1 

Function 

Where  Described 

ScrollTableRowToEntrv 

See  Section  2.22.1.34.1. 

SetScrollTableSelection 

See  Section  2.22.1.37.2. 

Table  2.13-121:  ReconstVehicleSelect  Information. 


2.13.5.3.7  ReconstEvent 

ReconstEvent  is  called  when  a  button  in  the  reconst  dialog  is  pressed.  It  determines 
whether  the  data  entered  is  valid  and  puts  up  the  appropriate  dialog.  The  routine  returns  the 
item  number  of  the  button  pressed.  The  function  cdl  is  ReconstEvent(dialog,  itemNo). 
Table  2.13-122  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  ;libmac: 
dialoQ.h 

itemNo 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

do  nothing  upon  return 

itemNo 

int 

resource  id  of  the  button  hit 

1  1 
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1  Calls  1 

Function 

Where  Described 

ShowVehicleDialoq 

See  Section  2.22.2.9.5. 

HideWindow 

Standard  Window  Manager  function  for  Macintosh. 

ShowWindow 

Standard  Window  Manager  function  for  Macintosh. 

DisposeScrollTable 

See  Section  2.22.1.30.2. 

OialoqSegNext 

See  Section  2.22.1.39.4. 

TruckReconstStart 

See  Section  2.13.5.3.2. 

ShowBtryReconstDialoq 

See  Section  2.13.4.2.10. 

ShowCEWReconstDialoq 

See  Section  2.13.4.4.10. 

Table  2.13-122;  ReconstEvent  Information. 


2.13.6  Simulating  Gunnery  Targets 


2.13.6.1  target.h 

Development:SIMNET;MCC:SCC:target.h 

target.h  is  the  header  file  associated  with  the  following  three  files;  target.c,  tgtentry.c  and 
tgttable.c.  Table  2.13-123  describes  the  variables  used  by  target.h. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

targetTableField 

extern  ScrotITableFieldDefn 

Development:SIMNET  :libmac: 
scroll.h 

targetColumns 

extern  array  of 

Scroll!  ableColumnDef  n 

Development:SIMNET  :libmac: 
scroll.h 

targetlableOialogDefn 

extern  OialogDefn 

Development:SiMNET  ilibmac: 
dialog. h 

targetOialog 

poiner  to  extern  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

Table  2.13-123;  target.h  Variable 

Information. 

2.13.6.2  target.c 

Development:SIMNET;MCC:SCC:target.c 

target.c  contains  routines  for  creating,  discarding,  and  communicating  to  the  host 
descriptions  of  gunnery  targets.  Table  2.13-124  describes  the  variables  used  by  target.c. 

1  Variables  1 

Variable 

Where  Typedef  Declared 

target  Dialog 

poiner  to  DialogState 

Development:SIMNET  :libmac: 
dialog. h 

targetByNumber 

array  of 

numberGunnery!  argets 
TargetHandle 

Development:SIMNET  :MCC: 
SCC:target.h 

numberExistinqTarqets 

int 

Standard  C  type. 

Table  2.13-124;  target.c  Variable  Information. 
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2.13.6.2.1  NewTarget 

NewTarget  allocates  a  new  target  descriptor.  The  function  call  is  NewTarget().  Table 
2.13-125  describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

tgt 

register  TargetHandle 

Development.SIMNET  ;MCC: 
SCClarqet.h 

i 

short 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

tgt 

TargetHandle 

Allocated  target  descriptor. 

Calls 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manager  function  for  Macintosh. 

DisableControl 

See  Section  2.22.1.7.1. 

Called  By 

Function 

Where  Described 

TargetTableEvent 

See  Section  2.13.6.4.9. 

ReadGunneryTarqets 

See  Section  2.13.8.12.4. 

I 


Table  2.13-125:  NewTarget  Information. 

2.13.6.2.2  RemoveTarget 

RemoveTarget  throws  away  a  target,  tgt.  The  host  is  notified  that  the  target  does  not  exist 
any  more,  the  scrolling  table  of  targets  is  updated,  and  the  New  Target  button  is  enabled  if 
the  maximum  number  of  targets  has  not  been  reached.  The  function  call  is 
RemoveTarget(tgt).  Table  2.13-126  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

tgt 

register  TargetHandle 

Development:SIMNET  :MCC: 
SCC:target.h 

Calls 

Function 

Where  Described 

UploadTarget 

See  Section  2.13.6.2.5. 

RemoveScrollTableEntry 

See  Section  2.22.1.28.1. 

EnableControl 

See  Section  2.22.1.7.2. 

Called  By 

Function 

Where  Described 

TargetEntryEvent 

See  Section  2.13.6.3.3. 

WipeTargetTable 

See  Section  2.13.8.12.5. 

Table  2.13-126:  RemoveTarget  Information. 
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2.13.6.2.3  TargelHit 

TargetHit  is  called  when  the  host  has  notified  us  that  the  target  has  been  destroyed.  The 
function  call  is  TargetHit(n).  Table  2.13-127  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

n 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

tgt 

register  TargetHandle 

Oevelopment:SIMNET  ;MCC: 
SCClarqel.h 

1  Calls  1 

1  Function 

Where  Described 

I^IIIIIIIIIIIHIIIIIllll  — 

See  Section  2.22.1.31.1. 

1  Called  Bv  1 

Function 

Where  Described 

ProcessRequest 

See  Section  2.13.8.6.1. 

Table  2.13-127:  TargetHit  Information. 

2.13.6.2.4  ResetTargets 

ResetTargets  restores  destroyed  targets  to  health.  The  function  call  is  ResetTargets(). 
Table  2.13-128  describes  the  internal  variables  used  and  functions  called  using  this 
function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

tgt 

register  TargetHandle 

Deyelopment:SIMNET  ;MCC: 
SCC:target.h 

Calls 

Function 

Where  Described 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

UpdateScrollTableEntry 

See  Section  2.22.1.31.1. 

UploadTarqet 

See  Section  2.13.6.2.5. 

Called  By 

Function 

Where  Described 

TarqefTableEvent 

See  Section  2.13.6.4.9. 

Table  2.13-128:  ResetTargets  Information. 
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2.13.6.2.5 


UploadTarget 


UploadTarget  notifies  the  host  about  a  gunnery  target,  tgt.  This  function  will  only  compile 
if  VERSION  is  APPLETALK.  Otherwise,  it  is  a  dummy  function.  The  function  call  is 
UploadTarget(tgt).  Table  2.13-129  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

tgt 

TargetHandle 

DevelopmentiSIMNET  :MCC; 
SCClarqet.h 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

req 

SCCTargetSetRequest 

DevelopmentiSIMNET  :MCC: 
SCCiSCC.h 

1  Calls  1 

Function 

Where  Described 

ATPPut 

See  Section  2.22.1.3.3. 

1  Called  Bv  1 

Function 

Where  Described 

RemoveTarqet 

See  Section  22.13.6.2.2 

ResetTarqets 

See  Section  2.13.6.2.4. 

TarqetEntrvEvent 

See  Section  2.13.6.3.3. 

ReadGunneryTarqets 

See  Section  2.13.8.12.4. 

Table  2.13*129:  UploadTarget  Information. 
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2.13.6.3  tgtentry.c 

Development:SIMNET  :MCC:SCC:tgtentry.c 

tgtentry.c  implements  the  dialog  for  defining  a  gunnery  target  Table  2.13-130  describes 
the  variables  used  by  tgtentry.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

targetEntryDialogDefn 

extern  DialogDefn 

DevelopmentiSIMNET  ;libmac; 
dialog. h 

currentTarget 

TargetHandle 

DevelopmentiSIMNET  :MCC: 
SCCrtarget.h 

targetBuffer 

Gunnery!  argelDescriptor 

DevelopmentiSIMNET  iMCCi 
SCCitarqet.h 

targetCancelField 

PushButtonFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

targetRemove  Field 

PushButtonFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

targetNameField 

TextFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

targetTypeFields 

array  of  RBFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

targetForceFields 

array  of  RBFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

targetLocationFieid 

CoordinatesFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

targetAzimuthField 

NumberFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

targetEntryFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

targetEntryDialogDefn 

DialogDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

Table  2.13-130:  tgtentry.c  Variable  Information. 
2.13.6.3.1  ShowTarget 


ShowTarget  pops  up  a  dialog  which  allows  the  definition  of  a  gunnery  target,  tgt.  The 
function  call  is  ShowTarget(tgt,  box).  Table  2.i3-131  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

tgt 

TargetHandle 

DevelopmentiSIMNET  iMCCi 
SCCitarqet.h 

box 

pointer  to  Red 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTvpes.h 

1  Calls  1 

1  Function 

Where  Described 

See  Section  2.22.1.11.1. 

LabelForceButtons 

See  Section  2.22.1.16.1. 

ZoomToWindow 

See  Section  2.22.1.47.4. 

ShowWindow 

Standard  Window  Manager  function  for  Macintosh. 
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Called  Bv 

Function 

Where  Described 

TargetTableSelect 

See  Section  2.13.6.4.3. 

TarqetTableEvent 

See  Section  2.13.6.4.9. 

Table  2.13-131:  ShowTarget  Information. 

2.13.6.3.2  TargetEntryFetch 

TargetEntryFetch  reads  the  current  values  of  the  target  entries  into  the  dialog  fields  for 
display  to  ^e  user.  The  function  call  is  TargetEntryFetch(state).  Table  2.13-132  describes 
the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

state 

pointer  to  DialogState 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

Called  Bv 

Function 

Where  Described 

TargetEntryEvent 

See  Section  2.13.6.3.3. 

Table  2.13-132:  TargetEntryFetch  Information. 

2.13.6.3.3  TargetEntryEvent 

TargetEntryEvent  is  called  when  a  button  in  the  target  entry  dialog  is  pressed.  If  the  Help 
button  is  pressed,  the  Help  dialog  is  put  up.  If  the  Cancel  button  is  pressed,  the  dialog  is 
updated.  If  the  Remove  button  is  pressed,  the  selected  target  is  removed.  If  the  OK  button 
is  pressed,  the  validity  of  the  selection  is  checked,  and  the  entry  dialog  is  put  up.  The  item 
number  of  the  button  pressed  is  returned.  The  function  call  is  TargetEntryEvent(state, 
itemNo).  Table  2.13-133  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

row 

int 

Standard  C  type. 

box 

Rect 

DeveiopmentiTHiNK  C: 

Ma:  #includes:MacTypes.h 

1  1 
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Function 


showhel 


TaraetEntrvFetch 


UodateDialo 


RemoveTaraet 


ThrowDialo 


CheckMandatorvFields 


InstallScrollTableEnt 


ScrollTableEnttvToRow 


ScrollTableRowRect 


HideWindow 


ZoomToWindow 


UploadTaroet 


Calls 


Where  Described 


See  Section  2.22.1.19.4. 


See  Section  2.13.6.3.2. 


See  Section  2.22.1.11.2. 


See  Section  2.13.6.2.2. 


See  Section  2.22.1.11.3. 


See  Section  2.22.1.13.1. 


See  Section  2.22.1.21. 


See  Section  2.22.1.34.2. 


See  Section  2.22.1.34.3. 


Standard  Window  Manaoer  function  for  Macintosh. 


See  Section  2.22.1.47.4. 


See  Section  2.13.6.2.5. 


Table  2.13-133:  TargetEntryEvent  Information. 

2.13.6.4  tgttable.c 

Development:SIMNET:MCC:  SCC:tgttable.c 

tgttable.c  implements  the  dialog  displaying  the  scrolling  table  of  gunnery  targets.  Table 
2.13-134  describes  the  variables  used  by  tgttable.c. 


internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

targetColumns 

array  of 

ScrollTableCotumnDefn 

DevelopmentiSIMNET  ilibmac: 
scroll,  h 

targetlableField 

ScrollTableFieldDefn 

Development:SIMNET  :libmac: 
scroll.h 

targetTableFieldList 

pointer  to  array  of  FieldDefn 

Development:SIMNET  ilibmac; 
dialoq.h 

targetTableDialogDefn 

Dialog  Defn 

Development:SIMNET  :libmac; 
dialoq.h 

Table  2.13-134:  tgttable.c  Variable  Information. 

2.13.6.4.1  SetUpTargets 

SetUpTargets  initializes  the  target  table.  The  Target  Table  dialog  is  opened  and  the  Target 
List  is  created.  The  function  call  is  SetUpTargetsQ.  Table  2.13-135  describes  the 
functions  called  using  this  function. 


Function 


TextFonf 


TextSize 


CharWidth 


StrinqWidth 


ShowDialo 


Calls 


Where  Described 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


See  Section  2.22.1.11.1. 
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1  Called  Bv  1 

Function 

Where  Described 

Setup 

See  Section  2.13.8.17.1. 

Table  2.13-135:  SetUpTargets  Information. 

2.13.6.4.2  ShowTargetTable 

ShowTargetTable  makes  the  gunnery  target  table  dialog  visible.  The  function  call  is 
ShowTargetTable().  Table  2.13-136  describes  the  functions  called  using  this  function. 


I  Calls  I 

Function 

Where  Described 

Show  Window 

Standard  Window  Manaaer  function  for  Macintosh. 

Select  Window 

Standard  Window  Manaoer  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

BMOverviewEvent 

See  Section  2.13.8.16.4. 

Table  2.13-136:  ShowTargetTable  Information. 

2.13.6.4.3  TargetTableSelect 

TargetTableSelect  is  called  when  an  entry  in  the  target  table  is  selected.  It  checks  for 
validity  of  the  selection  and  brings  up  the  next  dialog  describing  the  selection.  The  function 
call  is  TargetTabIeSelect(defn,  row,  box).  Table  2.13-137  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScroIlTableFieldDef  n 

Development:SIMNET:libmac 
scroll. h 

row 

int 

Standard  C  type. 

box 

pointer  to  Rect 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

entry 

ScrollTableEntryHandle 

DevelopmentiSIMNET  :libmac; 
scroll.h 

Calls 

Function 

Where  Described 

ScrollTableRowToEntry 

See  Section  2.22.1.34.1. 

ShowTarqet 

See  Section  2.13,6,3.1. 

Table  2.13-137:  TargetTableSelect  Information. 
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2.13.6.4.4  TargetTableHilite 

TargetTableHilite  draws  a  box  around  the  given  selection  so  the  user  knows  the  item  is 
selected.  The  function  call  is  TargetTableHilite(defn,  entry,  box).  Table  2.13-138 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  :libmac; 
scroll.h 

entry 

ScrollT  able  EntryHandle 

DevelopmentrSIMNET  :libmac; 
scroll.h 

box 

pointer  to  Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTvDes.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

hitPattern 

Pattern 

Development:THINK  C: 

Mac  #includes:Quickdraw.h 

1  Calls  1 

Function 

Where  Described 

PenMode 

Standard  Quickdraw  function  for  Macintosh. 

PenPal 

Standard  Quickdraw  function  for  Macintosh. 

PaintRect 

Standard  Quickdraw  function  for  Macintosh. 

PenNormal 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.13*138:  TargetTableHilite  Information. 

2.13.6.4.5  TargetDrawName 

TargetDrawName  fills  in  the  target  name  for  the  specified  column  in  the  target  table  to 
display  to  the  user.  The  function  call  is  TargetDrawName(defn,  col,  entry,  box).  Table 
2.13-139  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development.SIMNET  rlibmac; 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

Development:SIMNET  :libmac: 
scroll.h 

entry 

register 

ScrollT  ableEntrvHandle 

DevelopmentiSIMNET  ilibmac; 
scroll.h 

box 

pointer  to  Rect 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

Calls 

Function 

Where  Described 

DrawText 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.13-139:  TargetDrawName  Information. 
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2.13.6.4.6  TargetDrawType 

TargetDrawType  fills  in  the  type  field  for  the  specified  column  in  the  target  table  according 
to  the  data  structures  to  display  to  the  user.  The  function  call  is  TargetI^wType(defn,  col, 
entry,  box).  Table  2.13-140  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

defn 

pointer  to 

ScrollT  ableFieldOef  n 

DevelopmentiSIMNET  :libmac: 
scroll.h 

col 

pointer  to 

Scro  IIT  ableCo  lumnDefn 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

entry 

register 

ScrollT  ableEntrvHandle 

DevetopmentiSIMNET  ilibmac: 
scroll.h 

box 

pointer  to  Rect 

Development.THINK  C: 

Mac  #includes:MacTvp€s.h 

Internal  Variables 

1  Variable 

Where  Typedef  Declared 

pointer  to  array  of  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.13-140;  TargetDrawType  Information. 

2.13.6.4.7  TargetDrawAppearance 

TargetDraw Appearance  fills  in  the  appearance  field  for  the  specified  column  in  the  target 
table  to  display  to  the  user.  The  function  call  is  TargetDrawAppearance(defn,  col,  entry, 
box).  Table  2.13-141  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

col 

pointer  to 

ScrollT  ableColumnDef  n 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

entry 

register 

Scrol  ITable  EntryHandle 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

box 

pointer  to  Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

Calls 

Function 

Where  Described 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.13-141:  TargetDrawAppearance  Information. 
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2.13.6.4.8  TargetDrawLocation 

TargetDrawLocation  fills  in  the  location  field  for  the  specified  column  in  the  target  table  to 
display  to  the  user.  The  function  call  is  TargetDrawLocation(defn,  col,  entry,  box).  Table 
2.13-142  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

Scro  IIT  ableFieldDef  n 

Development:SIMNE!  :libmac; 
scroll.h 

col 

pointer  to 

Scroll!  ableColumnDef  n 

DevelopmentiSIMNE!  :iibmac; 
scroll.h 

entry 

register 

Scroll!  ableErrtrvHandle 

Development:SIMNE!  :Hbmac; 
scroll.h 

box 

pointer  to  Rect 

Devetopment:!HINK  C: 

Mac  #includes:Mac!ypes.h 

1  Calls  1 

Function 

Where  Described 

DrawText 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.13'142:  TargetDrawLocation  Information. 
2.13.6.4,9  TargetTableEvent 


TargetTableEvent  is  called  when  an  event  occurs  in  the  target  table  dialog.  If  the  Help 
button  is  pressed,  the  help  dialog  is  put  up.  If  the  New  button  is  pressed,  it  gets  a  new 
target.  If  the  Overview  button  is  pressed,  the  overview  screen  is  put  up.  The  item  number 
of  the  button  pressed  is  returned.  TTie  function  call  is  TargetTableEventfdialog,  itemNo). 
Table  2.13-143  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

!ype 

Where  !ypedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNE!;libmac; 

dialoq.h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

!ype 

Where  !ypedef  Declared 

tgt 

register  !argetHandle 

DevelopmentiSIMNE!  :MCC: 
SCCiruck.h 

i 

int 

Standard  C  type. 

theltem 

Handle 

Development:!HINK  C; 

Mac  #includes:Mac!ypes.h 

box 

Rect 

Development:!HINK  C; 

Mac  #includes:Mac!ypes.h 

1  1 

BBN  Systems  and  Technologies 


MCC  CSCl 


1  Calls  1 

Function 

Where  Described 

showhelp 

See  Sectioii  2.22.1.19.4. 

NewTarqet 

See  Section  2.13.6.2.1. 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

ShowTaraet 

See  Section  2.13.6.3.1. 

ResetTargets 

See  Section  2.13.6.2.4. 

HideWindow 

Standard  Window  Manager  function  for  Macintosh. 

Table  2.13-143:  TargetTableEvent  Information. 
2.13.7  Visual  Appearance  of  SCC  User  Interface 


2.13.7.1  SCC  Pictures 

Development:SIMNET:MCC:SCC:SCC  Pictures 

SCC  Pictures  contains  resources  that  determine  the  appearance  of  the  SCC  application's 
user  interface. 

2.13.7.2  resource. h 

Development :  S IMNET ;  MCC:  SCCrresource.h 

resource.h  defines  the  numbers  of  the  resources  present  in  the  SCC  Pictures  resource  file. 


2.13.8  Auxiliary  Software 


2.13.8.1  SCC.h 

Development:SIMNET:MCC:SCC:SCC.h 

SCC.h  defines  the  representation  of  information  communicated  between  the  SCC 
Macintosh  application  and  the  MCC  host. 

2.13.8.2  SCCMac.h 

Development:SIMNET:MCC:SCC:SCCMac.h 

SCCMac.h  defines  types,  constants,  and  routines  used  within  the  SCC  Macintosh 
application.  Table  2. 13-144  describes  the  variable  used  by  SCCMac.h. 
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Variable 


battleScheme 


forcelD 


terrainSelection 


terrains 


optionalElementInfo 


optionalElements 


numberHowitzerBattenes 


trainsOraanization 


supportPItLocation 


fuelLocation 


ammoLocation 


umcpLocation 


coTrainLocations 


class3SPLocation 


class3DPLocation 


aspLocation 


atpLocation 


adminLogLocation 


ammoSupplyRate 


seqDialog 


entryOialog 


initOverview  Dialog 


bmOverviewDailog 


watchCursorHandle 


bm  Password 


Variables 


e 


extern  char 


extern  char 


extern  char 


extern  array  of 
TerrainSelection 


extern  array  of 
OotionalElementlnfo 


extern  OptionalElements 


extern  int 


extern  char 


extern  MapCoordinates 


extern  MapCoordinates 


extern  MapCoordinates 


extern  MapCoordinates 


extern  array  of 

maxNumberCompanies 

MaoCoordinates 


extern  MapCoordinates 


extern  MapCoordinates 


extern  MapCoordinates 


extern  MapCoordinates 


extern  MapCoordinates 


extern  array  of 
numberAmmoVarieties  int 


pointer  to  DialogSeqState 


pointer  to  DialogState 


extern  OiaiogNodeDefn 


extern  OiaiogNodeDefn 


extern  CursHandle 


extern  array  of  char 
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Where  Tvpedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Development:SIMNET  :MCC: 
SCC;SCCMac.h 


Development:SIMNET  :MCC: 
SCC:SCCMac.h 


Development:SIMNET  :MCC: 
includeioDtions.h 


Standard  C  type. 


DevelopmentiSIMNET  ilibmac; 
map.h 


DevelopmentiSIMNET  ilibmac; 
map.h 


DevelopmentiSIMNET  ilibmac; 
map.h 


DevelopmentiSIMNET  ilibmac; 
map.h 


DevelopmentiSIMNET  ilibmac; 
map.h 


DevelopmentiSIMNET  ilibmac; 
map.h 


DevelopmentiSIMNET  ilibmac; 
map.h 


DevelopmentiSIMNET  ilibmac; 
map.h 


DevelopmentiSIMNET  ilibmac; 
map.h 


DevelopmentiSIMNET  ilibmac; 
map.h 


Standard  C  type. 


DevelopmentiSIMNET  ilibmac; 
sequence. h 


DevelopmentiSIMNET  ilibmac; 
dialoo.h 


DevelopmentiSIMNET  ilibmac; 
sequence. h 


DevelopmentiSIMNET  ilibmac; 
sequence. h 


DevelopmentiTHINK  C; 
Mac  #includesiQuickdraw.h 


Standard  C  type. 


Table  2.13-144:  SCCMac.h  Variable  Information. 


2.13.8.3  see  #includes.c 

DevelopmentiSIMNET;  MCC;  SCCiSCe  #includes.c 

sec  #includes.c  is  compiled  by  the  THINK  C  compiler  to  produce  a  precompiled  header 
file,  "SCC  Headers",  that  is  included  by  various  SCC  source  code  files. 
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2.13.8.4  SCCoptions.h 

Development:SIMNET:MCC:SCC:  SCCoptions.h 

SCCoptions.h  associates  a  constant  with  each  type  of  optional  element  that  may  be 
simulated  by  the  MCC  system. 

2.13.8.5  version. h 

Development:SIMNET:MCC:SCC:version.h 

version.h  defines  constants  that  determine  which  version  of  the  SCC  application  is 
compiled. 


2.13.8.6  atalk.c 

DevelopmentrSIMNET  :MCC:SCC:atalk.c 

atalk.c  contains  routines  supporting  AppleTalk  communication  between  the  SCC  Macintosh 
application  and  the  MCC  host.  The  functions  in  this  file  are  only  compiled  if  VERSION  is 
APPLETALK. 

2.13.8.6.1  ProcessRequest 

ProcessRequest  processes  a  request  received  from  the  MCC  host.  The  function  call  is 
ProcessRequest(hdl).  Table  2.13-145  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

hdl 

Handle 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

P 

register  Rr 

DeyelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

errCode 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

SetDateTime 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

TaraetHit 

See  Section  2.13.6.2.3. 

ATPResponse 

Standard  Appletalk  Manaqer  function  for  Macintosh. 

Restart 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

ProcessSimPlacedRequest 

See  Section  2.22.2.3.4. 

SimulatorPlaced 

See  Section  2.13.2.2.8. 

ProcessSimProblemRequest 

See  Section  2.13.8.6.2. 

ATPError 

See  Section  2.22.1.3.6. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.13.8.15.1. 

Table  2.13-145:  ProcessRequest  Information. 
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2.13.8.6.2  ProcessSimProblemRequest 

ProcessSimProblemRequest  reports  a  problem,  problem,  with  a  vehicle  simulator,  vehicle. 
The  function  call  is  ProcessSiniProblemRequest(vehicle,  problem).  Table  2.13-146 
describes  the  parameters  used  and  functions  call^  using  this  function. 


Parameter 


vehicle 


roblem 


r 


Parameters 


IBT? 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Variable 


cStr 


Internal  Variables 


array  of  100  char 


Where  Tvoedef  Declared 


Standard  C  type. 


Function 


ShowCaution 


Calls 


Where  Described 


See  Section  2.22.1.4.1. 


Function 


ProcessRequest 


Called  B 


Where  Described 


See  Section  2.13.8.6.1. 


Table  2.13-146:  ProcessSimProblemRequest  Information. 


2.13.8.6.3  DownloadTerrain 


DownloadTerrain  obtains  information  about  terrain  patches  from  the  host.  The  function 
call  is  DownloadTerrain().  Table  2.13-147  describes  the  internal  variables  used  and 
functions  called  using  this  function. 

_ Internal  Variables _ 


Variable 

Type 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

tp 

register  pointer  to 
TerrainSelection 

Deyelopment:SIMNET  :MCC: 
SCC-.SCCMac.h 

abl 

ABRecHandle 

DeyelopmentTHINK  C: 

Mac  #includes:Appletalk.h 

ab2 

ABRecHandle 

DevelopmentTHINK  C: 

Mac  #includes:Appletalk.h 

reql 

SCCTerrainRequest 

Deyelopment:SIMNET  :MCC: 
SCCtSCC.h 

rsp1 

SCCTerrainResponse 

Deyelopment:SIMNET  :MCC; 
SCCiSCC.h 

req2 

SCCMapSheetsRequest 

Deyelopment:SIMNET  :MCC: 
SCC;SCC.h 

rsp2 

SCCMapSheetsResponse 

Deyelopment;SIMNET  :MCC: 
SCC:SCC.h 

errCode 

int 

Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manaqer  function  for  Madniosh. 

SetUpATPRequest 

See  Section  2.22.1.3.2. 

ATPError 

See  Section  2.22.1.3.6. 

ATPRequest 

Standard  Appletalk  Manaqer  function  for  Macintosh. 

DisposHandle 

Standard  Memory  Manaqer  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

main 

See  Section  2.13.8.15.1. 

Table  2.13*147:  DownloadTerrain  Information. 

2.13.8.6.4  DownloadOptions 

DownloadOptions  obtains  information  about  which  optional  elements  are  supportable.  The 
function  call  is  DownloadOptions().  Table  2.13-148  describes  the  internal  variables  used 
and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

rsp 

SCCPermitOptionsResponse 

Development:SIMNET  :MCC: 
SCC:SCC.h 

Calls 

Function 

Where  Described 

ATPPut 

See  Section  2.22.1.3.3. 

PermitOptionalElements 

See  Section  2.13.8.11.9. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.13.8.15.1. 

Table  2.13-148; 


DownloadOptions  Information. 
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Developnient:SIMNET:MCC:SCC:data.c 
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data.c  defines  various  data  structures  used  by  the  SCC  application,  such  as  tables  of 
information  about  supply  trucks.  Table  2.13-149  describes  the  variables  used  by  data.c. 


Variables 


Variable 


apDlication 


authors 


terrainSelection 


terrains 


optionalElements 


numberHowitzerBatteries 


trainsOraanization 


supportPItLocation 


fuelLocation 


ammoLocation 


umcpLocation 


coTrain  Locations 


class3SPLocation 


classSDPLocation 


aspLocation 


atpLocation 


ammoSupplyRate 


seqDialog 


entry  Dialog 


watchCursorHandle 


bmPassword 


Type _ 

inter  to  char 

inter  to  char 

po 

inter  to  char 

char 


array  of  maxNumberTerrains 
TerrainSelection 


OptionalElements 


mt 


char 


MapCoordinater 


MapCoordinates 


MapCoordi  nates 


MapCoordinates 


array  of 

maxNumbercompanies 

MapCoordinates 


MapCoordinates 


MapCoordinates 


MapCoordinates 


MapCoordinates 


array  of 

numberAmmoVarieties  int 


pointer  to  DialogSeqState 


pointer  to  DialogState 


CursHandle 


array  of  bmPasswordLength 
char 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Development:SIMNET  :MCC: 
SCC:SCCMac.h 


Development.SIMNET  :MCC: 
include;options.h 


Standard  C  type. 


Standard  C  type. 


Development;SIMlslET;libmac: 

map.h 


DevelopmentiSIMNET  Mibrnac: 
map.h 


Development;SIMNET  ;libmac: 
map.h 


Development;SIMNET;libmac; 

map.h 


Deyelopment:SIMNET;libmac: 

map.h 


Development;SIMNET;libmac: 

map.h 


Development:SlMNET:libmac; 

map.h 


DeyelopmentiSIMNET  :libmac; 
map.h 


Deyelopment:SIMNET  ilibmac: 
map.h 


Standard  C  type. 


DevelopmentiSIMNET  ;libmac; 
sequence. h 


DevelopmentiSIMNET  :libmac: 
dialog. h 


DevelopmentTHINK  C; 
Mac  #includes;Quickdraw.h 


Standard  C  type. 


Table  2.13-149:  data.c  Variable  Infurmation. 


2.13.8.8  dialog.c 

Development:SIMNET:MCC:SCC:dialog.c 

dialog.c  contains  miscellaneous  routines  supporting  dialog  implementations. 
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2.13.8.8.1  CheckMandatoryEvent 


CheckMandatoryEvent  checks  to  see  if  the  button  pressed  was  the  Next  button  and  checks 
the  validity  of  the  next  field.  The  function  call  is  CheckMandatoryEvent(dialog,  itemNo). 
Table  2.13-150  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

dialog 

pointer  to  OialogState 

Development:SlMNET  :libmac; 
dialog. h 

itemNo 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

do  nothing  upon  return 

itemNo 

int 

resource  id  of  the  button  hit 

1  Calls  1 

Function 

Where  Described 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

Table  2.13-150:  CheckMandatoryEvent  Information. 
2.13.8.8.2  ZoomUpFromTableEntry 

ZoomUpFromTableEntry  draws  an  animated  rectangle  that  starts  the  size  of  the  table  entry 
and  shrinks  to  the  size  of  the  pop-up  window,  then  displays  the  pop-up  window.  The 
function  call  is  ZoomUpFromTableEntry  (box).  Table  2.13-151  describes  the  parameters 
used  and  functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

box 

register  pointer  to  Rect 

Development'.THINK  C: 

Mac  #includes:MacTypea.r( 

Calls 

Function 

Where  Described 

ZoomToWindow 

See  Section  2.22.1.47.4. 

ShowWindow 

Standard  Window  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

AllocTableSelect 

See  Section  2.13.2.1.3. 

PlaceTableSelect 

See  Section  2.13.2.2.6. 

TruckTableSelect 

See  Section  2.13.3.4.10. 

Table  2.13-151:  ZoomUpFromTableEntry  Information. 
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2.13.8.8.3  ZoomDownToTableEntry 

ZoomDownToTableEntry  hides  the  pop-up  window  and  then  draws  an  animated  rectangle 
that  grows  from  the  size  of  the  pop-up  window  to  the  size  of  the  table  entry.  The  function 
call  is  ZoomDownToTableEntiyO.  Table  2.13-152  describes  the  functions  called  using 
this  function. 


1  Calls  1 

Function 

Where  Described 

Hide  Window 

Standard  Window  Manaqer  function  for  Macintosh. 

ZoomTo  Window 

See  Section  2.22.1.47.4. 

Called  By 

Function 

Where  Described 

AllocEntrvEvent 

See  Section  2.13.2.1.6. 

PlaceComplete 

See  Section  2.13.2.2.5. 

T  ojckT  ableComplete 

See  Section  2.13.3.4.9. 

Table  2.13-152:  ZoomDownToTableEntry  Information. 

2.13.8.9  displace. h 

E)evelopment;SlMNET:MCC;SCC:displace.h 

displace. h  header  file  associated  with  the  following  file,  displace.c.  Table  2.13-153 
describes  the  variables  used  by  displace.h. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

displacelable 

extern  array  of  DisplaceData 

DevelopmentiSIMNET  :MCC: 
SCC;displace.h 

Table  2.13-153:  displace.h  Variable  Information. 

2.13.8.10  displace.c 

Development:SlMNET:MCC:SCC;displace.c 

di.splace.c  implements  the  displacement  of  units  such  as  howitzer  batteries  and  command 
po.sts.  Table  2.13-154  describes  the  variables  used  by  displace.c. 
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Variables 


Variable 

Type 

Where  Typedef  Declared 

dispElementColumn 

Scro  III  ableColumnDef  n 

DevelopmentiSIMNET  :libmac; 
scroll.h 

dispElementTableField 

ScrollT  ableFieldDef  n 

DevelopmentiSIMNET  ilibmac; 
scroll.h 

dispUnitColumns 

array  of 

ScrollT  ableColumnDefn 

Deveiopment:SIMNET:libmac; 

scroll.h 

dispUnitTablePield 

ScrollTable  FieldDef  n 

DevelopmentiSIMNET  :libmac: 
scroll.h 

displaceFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  :libmac: 
dialog. h 

displaceDialog 

DialogNodeDefn 

Development:SIMNET:libmac; 
sequence. h 

dispElementSelection 

int 

Standard  C  type. 

dispUnitSelection 

int 

Standard  C  type. 

newLocation 

MapCoordinates 

Development:SIMNET  ;libmac; 
map.h 

displaceTabfe 

array  of 

displacelableMaxEntries 

DisolaceData 

Development.SIMNET.MCC; 

SCCidisplace.h 

supplyDepotsInited 

extern  char 

Standard  C  type. 

displaceDispatch  Dialog 

extern  DialogNodeDefn 

Development'.SIMNET  :libmac: 
sequence. h 

displaceHalt  Dialog 

extern  DialogNodeDefn 

DevelopmentiSIMNET  ilibmac; 
sequence. h 

bmOverviewDialog 

extern  DialogNodeDefn 

Development:SIMNET  ;libmac: 
sequence. h 

displaceDispatchButtonFields 

array  of  PushButtonfieldDefn 

Development:SIMNET  ilibmac: 
dialog. h 

displaceDispatchNewLocation 

Field 

CoordinatesFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

displaceDispatchFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

displaceDispatchDialog 

DialogNodeDefn 

DevelopmentiSIMNET  ilibmac: 
sequence. h 

displaceHaltButtonFields 

array  of  PushButtonFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialoq.h 

displaceHaltFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialoq.h 

displaceHalt  Dialog 

DialogNodeDefn 

DevelopmentiSIMNET  ilibmac: 
sequence. h 

Table  2.13*154:  displace.c  Variable  Information. 
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2.13.8.10.1  CompleteDisplacement 


CompleteDisplacement  is  called  when  the  displacement  dialog  should  be  checked  for 
correctness  and  taken  down.  The  function  call  is  CompleteDisplacement().  Table 
2.13-155  describes  the  functions  which  call  this  function. 


1  Called  By  I 

Function 

Where  Described 

ProcessCommandShift  Option 
Sequence 

See  Section  2.13.8.15.4. 

Table  2.13-155:  CompleteDisplacement  Information. 
2.13.8.10.2  DisplaceFetch 

DisplaceFetch  reads  the  current  values  of  the  howitzers,  TOC,  ALOC,  UMCP,  and  depot 
elements  into  the  displacement  dialog  fields  to  display  to  the  user.  The  function  call  is 
DisplaceFetch(state).  Table  2.13-156  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

state 

pointer  to  OialogState 

DevelopmentiSIMNET  rlibmac; 
dialog,  h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

element 

register  DispElementHandle 

Development:SIMNET  :MCC: 
SCC:displace.h 

Calls 

Function 

Where  Described 

NewDispElement 

See  Section  2.13.8.10.9. 

InstallScrollTableEntry 

See  Section  2.22.1.21.1. 

DisplaceSelectElement 

See  Section  2.13.8.10.5. 

ScrollT  able  EntryToRow 

See  Section  2.22.1.34.2. 

Table  2.13-156:  DisplaceFetch  Information. 


2.13.8.10.3  DisplaceEvent 

DisplaceEvent  checks  the  status  of  the  Displace  Table.  If  the  status  is  stationary,  the 
Dispatch  dialog  is  put  up.  Otherwise,  the  Halt  dialog  is  put  up.  The  function  call  is 
DisplaceEvent(dialog,  itemNo).  Table  2.13-157  describes  the  parameters  used  by  this 
function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  rlibmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

1  1 
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1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

do  nothing  upon  return 

itemNo 

int 

resource  id  of  the  button  hit 

Table  2.13-157:  DisplaceEvent  Information. 


2.13.8.10.4  DisplaceBranch 

DisplaceBranch  is  used  when  there  is  a  list  of  items  to  select.  It  checks  the  type  of  item 
selected  and  brings  up  the  next  dialog,  depending  on  the  item  type.  The  function  call  is 
DisplaceBranch(state).  Table  2.13-158  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

state 

pointer  to  DialogSeqState 

DevelopmentiSIMNET  ;libmac: 
sequence. h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

&displaceDispatch  Dialog 

pointer  to  DiaiogNodeDefn 

handle  of  the  displace 

Dispatch  dialog 

&displaceHaltDialog 

pointer  to  DiaiogNodeDefn 

handle  of  the  displace  Halt 
dialog 

Table  2.13-158  DisplaceBranch  Information. 


2.13.8.10.5  DisplaceSelectElement 

DisplaceSelectElement  is  called  when  an  element  entry  in  the  dispatch  table  is  selected.  It 
checks  for  validity  of  selection  and  brings  up  the  next  dialog  describing  the  selection.  The 
function  call  is  DisplaceSelectElement(defn,  row,  box,  theEvent).  Table  2.13-159 
describes  the  parameters  used  and  functions  called  using  this  function. 
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I  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

entry 

register 

ScrollT  ableEntrvHandle 

Development:SIMNET  :libmac: 
scroll.h 

t1 

register 

ScrollT  able  EntrvHandle 

DevelopmentiSIMNET  :libmac; 
scroll.h 

t2 

register 

ScrollTableEntrvHandle 

Development;SIMNET  ilibmac: 
scroll.h 

unit 

register  DispUnitHandle 

DvelopmentiSIMNET'.MCC; 

SCCidisplace.h 

numHalves 

int 

Standard  C  type. 

i 

int 

Standard  C  type. 

savePort 

GrafRr 

Development:THINK  C: 

Mac  #includes:Quickdraw.h 

numberHowitzerBatteries 

extern  int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

ScrollTableRowToEntrv 

See  Section  2.22.1.34.1. 

SetScrollTableSelection 

See  Section  2.22.1.37.2. 

DisposHandle 

Standard  Memory  Manaqer  function  for  Macintosh. 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

Set  Port 

Standard  Quickdraw  function  for  Macintosh. 

InvalRect 

Standard  Window  Manager  function  for  Macintosh. 

NewDispUnit 

See  Section  2.13.8.10.8. 

InstallScrollTableEntry 

See  Section  2.22.1.21.1. 

1  Called  Bv  1 

Function 

Where  Described 

DisplaceFetch 

See  Section  2.13.8.10.2. 

Table  2.13-159:  DisplaceSelectElement  Information. 


2.13.8.10.6  DisplaceSelectUnit 

DisplaceSelectUnit  is  called  when  a  unit  entry  in  the  dispatch  table  is  selected.  It  checks  for 
the  validity  of  selection  and  brings  up  the  next  dialog  describing  the  selection.  The  function 
call  is  DisplaceSelectUnit(defn,row,  box,  theEvent).  Table  2.13-160  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

row 

int 

Standard  C  type. 

box 

pointer  to  Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

theEvent 

pointer  to  EventRecord 

DevelopmentiTHINK  C: 

Mac  ffincludesiEventMor.h 

BBN  Systems  and  Technologies 


MCCCSCI 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

entry 

register 

ScrollTableEntryHandle 

DevelopmentiSIMNET  :libmac: 
scroll.h 

Calls  1 

Function 

Where  Described 

SetScrollTableSeiection 

See  Section  2.22.1.37.2. 

ScrollTableRowToEntry 

See  Section  2.22.1.34.1. 

Table  2.13-160:  DisplaceSelectUnit  Information. 


2.13.8.10.7  NewDispEIement 

NewDispElement  allocates  memory  for  a  new  element  in  the  displacement  table  and  sets  up 
fields.  The  function  call  is  NewDispElement(key).  Table  2.13-161  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


variable 


element 


lETT! 


Internal  Variables 


e 


register  OispElementHandle 


Where  Tynedef  Declared 


Standard  C  tvoe. 


Where  Tvoedef  Declared 


Development:SIMNET  :MCC: 
SCC:displace.h 


Return  Values 

Return  Value 

Type 

Meaning 

element 

OispElementHandle 

Handle  to  the  data  structure 
describing  the  entry  that  was 
just  created 

Calls 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manager  function  for  Macintosh. 

Table  2.13-161:  NewDispEIement  Information. 
2.13.8.10.8  NewDispUnit 


NewDispUnit  allocates  memory  for  a  new  unit  in  the  displacement  table.  The  function  call 
is  NewDispUnit(index).  Table  2.13-162  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

index 

int 

Standard  C  tvoe. 
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variable 


unit 


Internal  Variables 


register  OispUnitHandle 


Where  Tvoedef  Declared 


Development:SIMNET  :MCC; 
SCC;displace.h 


Return  Value 


unit 


Return  Values 


Type _ 


OispUnitHandle 


Meaning  _ 


Handle  to  the  data  structure 
describing  the  entry  that  was 
just  created 


Calls 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manager  function  tor  Madntosh. 

Called  B 


Function 

Where  Described 

DisplaceSelectElement 

See  Section  2.13.8.10.5. 

2.13.8.10.9 


Table  2.13-162:  NewDispUnit  Information. 
DrawDispElement 


DrawDispElement  fills  in  element  fields  of  the  specified  column  in  the  displace  table  to 
display  to  the  user.  The  function  call  is  DrawDispElement(defn,  col,  entry,  box).  Table 
2.13-163  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development;SIMNET  ilibmac: 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

Development:SIMNET  ilibmac: 
scroll.h 

entry 

Scroll!  able  EntryHandle 

DevelopmentiSIMNET  :libmac; 
scroll.h 

box 

pointer  to  Rect 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

Calls 

Function 

Where  Described 

Move 

Standard  Quickdraw  function  for  Macintosh. 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

DisplaceFetch 

See  Section  2.13.8.10.2. 

Table  2.13-163:  DrawDi.spElement  Information. 
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2.13.8.10.10  DrawDispUnit 

DrawDispUnit  fills  in  unit  fields  of  the  specified  column  in  the  displace  table  to  display  to 
the  user.  The  function  call  is  DrawDispUnit(defn,  col,  entry,  box).  Table  2.13-lM 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ;libmac: 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

Development:SIMNET  itibmac; 
scroll.h 

entry 

ScrollTableEntryHandle 

Development:SIMNET  :libmac: 
scroll.h 

box 

pointer  to  Rect 

DevelopmentTHINK  C; 

Mac  #includes;MacTypes.h 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

index 

register  int 

Standard  C  type. 

cStr 

array  of  30  char 

Standard  C  type. 

pStr 

array  of  30  char 

Standard  C  type. 

unitNo 

short 

Standard  C  type. 

half 

char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

Move 

Standard  Ouickdraw  function  for  Macintosh. 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.13-164:  DrawDispUnit  Information. 


2.13.8.10.11  DrawDispStatus 


DrawDispStatus  fills  in  status  fields  of  the  specified  column  in  the  table  to  display  to  the 
user.  The  function  call  is  DrawDispStatus(defn,  col,  entry,  box).  Table  2.13-165 
describes  the  parameters  used,  errors  returned  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development:SIMNET  :libmac: 
scroll.h 

col 

pointer  to 

Scroll!  ableColumnDef  n 

Deyelopment:SIMNET  :libmac; 
scroll.h 

entry 

ScrollTableEntryHandle 

Deyelopment:SIMNET  :libmac: 
scroll.h 

box 

pointer  to  Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTvpes.h 

1  1 
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1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

unit 

register  DispUnitHandle 

Development:SIMNET  :MCC: 
SCC:displace.h 

index 

register  int 

Standard  C  type. 

cStr 

array  of  30  char 

Standard  C  type. 

oStr 

array  of  30  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

Move 

Standard  Quickdraw  function  for  Macintosh. 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.13-165:  DrawDispStatus  Information. 


2.13.8.10.12  DrawDispETA 

DrawDispETA  fills  in  ETA  fields  of  the  specified  column  in  the  displace  table  according  to 
the  data  structures  to  display  to  the  user.  The  function  call  is  E)rawDispETA(defn,  col, 
entry,  box).  Table  2.13-166  describes  the  parameters  used  and  functions  called  using  this 
function. 


Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

Scroll!  ableFieldDef  n 

Development:SIMNE!  ilibmac: 
scroll. h 

col 

pointer  to 

Scro  III  ableColumnDef  n 

Development:SIMNE!  :libmac: 
scroll. h 

entry 

Scroll!  able  EntryHandle 

Development:SIMNE!  ilibmac: 
scro  II.  h 

box 

pointer  to  Rect 

DevelopmentTHINK  C: 

Mac  #includes:Mac!ypes.h 

Internal  Variables 

Variable 

!ype 

Where  !Ypedef  Declared 

unit 

register  DispUnitHandle 

DevelopmentiSIMNE!  iMCC; 
SCCidisplace.h 

index 

register  int 

Standard  C  type. 

cStr 

array  of  30  char 

Standard  C  type. 

pStr 

array  of  30  char 

Standard  C  type. 

Calls  1 

Function 

Where  Described 

DTGToStrino 

See  Section  2.22.1.15.1. 

Move 

Standard  Quickdraw  function  for  Macintosh. 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.13-166:  DrawDispETA  Information. 
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2.13.8.10.13  SetUpDisplacement 

SetUpDispIacement  sets  up  the  displacment  dialog.  The  function  call  is 
SetUpDisplacement().  Table  2.13-167  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

Text  Size 

Standard  Quickdraw  function  for  Macintosh. 

String  Width 

Standard  Quickdraw  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

Setup 

See  Section  2.13.8.17.1. 

Table  2.13-167:  SetUpDisplacement  Information. 
2.13.8.10.14  DisplaceDispatchFetch 

DisplaceDispatchFetch  reads  the  current  values  of  the  dispatch  unit  data  from  the  displace 
table  into  the  displace  dispatch  dialog  fields  to  display  to  the  user.  The  function  call  is 
DisplaceDispatchFetch(state).  Table  2.13-168  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Deciared 

state 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialog,  h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

pLocation 

array  of  30  char 

Standard  C  type. 

cDispUnit 

array  of  30  char 

Standard  C  type. 

pDispUnit 

array  of  30  char 

Standard  C  type. 

data 

register  pointer  to 

DisplaceData 

Development:SIMNET  :MCC: 
SCC:displace.h 

Calls 

Function 

Where  Described 

ParamText 

Standard  Dialog  Manager  function  for  Macintosh. 

Table  2.13-168:  DisplaceDispatchFetch  Information. 
2.13.8.10.15  DisplaceDispatchEvent 

DisplaceDispatchEvent  is  called  when  a  button  in  the  displace  dispatch  dialog  is  pressed.  It 
determines  whether  the  data  entered  is  valid.  It  throws  the  current  dialog  away  and  goes  to 
the  main  screen.  It  returns  the  item  number  of  the  button  pressed.  The  function  call  is 
DisplaceDispatchEvent(dialog,  itemNo).  Table  2.13-169  describes  the  parameters  used 
and  functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  ;libmac; 
dialoq.h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

data 

register  pointer  to 

DisplaceData 

DevelopmentiSIMNET  :MCC: 
SCC:displace.h 

etaStrinq 

array  of  30  char 

Standard  C  type. 

tempTimeEntroute 

unsigned  long 

Standard  C  type. 

tempETA 

DateTimeGroup 

Development:SIMNET  rlibmac: 
dtq.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

0 

int 

do  nothing  upon  return 

itemNo 

int 

resource  id  of  the  pressed 
button 

1  Calls  1 

Function 

Where  Described 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

NetworkDispatched 

See  Section  2.13.8.10.21. 

ComputeETA 

See  Section  2.13.8.10.18. 

Get  DTG 

See  Section  2.22.1.15.4. 

DTGToStrinq 

See  Section  2.22.1.15.4. 

SetText 

See  Section  2.22.1.11.8. 

Table  2.13-169:  DisplaceDispatchEvent  Information. 


2.13.8.10.16  DisplaceHaltFetch 

DisplaceHaltFetch  reads  the  current  values  of  the  displace  data  structures  into  the  displace 
halt  dialog  fields  to  display  to  the  user.  The  function  call  is  DisplaceHaltFetch(state). 
Table  2.13-170  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


state 


Parameters 


pointer  to  DialogState 


Where  Tvoedef  Declared 


Development:SIMNET  ilibmac: 
dialoq.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

data 

register  pointer  to 

DisplaceData 

Development:SIMNET  :MCC: 
SCC:displace.h 

cDispUnit 

array  of  30  char 

Standard  C  type. 

DisoUnit 


Location 


ETA 


array  of  30  char 


array  of  30  char 


array  of  30  char 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

DTGToStrinq 

See  Section  2.22.1.15.1. 

ParamText 

Standard  Dialoq  Manaqer  function  for  Macintosh. 

Table  2.13-170:  DisplaceHaltFetch  Information. 


2.13.8.10.17  DisplaceHaltEvent 

DisplaceHaltEvent  is  called  when  a  button  in  the  displace  halt  dialog  is  pressed.  It 
determines  whether  the  data  entered  is  valid.  It  throws  the  current  ^ alog  away  and  goes  to 
the  main  screen.  It  returns  the  item  number  of  the  button  pressed.  The  function  call  is 
DisplaceHaltEvent(dialog,  itemNo).  Table  2.13-171  describes  the  parameters  used  and 
functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  ilibmac; 
dialoq. h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

data 

register  pointer  to 

DisplaceData 

Development:SIMNET  :MCC; 
SCCidisplace.h 

percent 

unsigned  long 

Standard  C  type. 

time 

DateTimeGroup 

DeyelopmentiSIMNET  :libmac: 
dtg.h 

I  Return  Values  I 

Return  Value 

Type 

Meaning 

itemNo 

int 

resource  id  of  pressed  button 

I  Calls  I 

Function 

Where  Described 

Get  DTG 

See  Section  2.22.1.15.4. 

comp  pet 

See  Section  2.13.8.10.19. 

PercentPt 

See  Section  2.22.1.23.3. 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

NetworkArrived 

See  Section  2.13.8.10.22. 

Table  2.13-171:  DisplaceHaltEvent  Information. 


2.13.8.10.18  ComputeETA 

ComputeETA  computes  an  ETA  given  the  current  location.  Location,  destination, 
Destination,  and  speed,  Speed.  It  returns  the  ETA  in  eta,  and  the  total  travel  time  in 
timeEnroute.  The  function  call  is  ComputeETA(Location,  Destination,  eta,  timeEnroute, 
speed).  Table  2.13-172  describes  the  parameters  used  and  functions  called  using  this 
function. 
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Parameter 


Location 


Destination 


timeEnroute 


speed 


Parameters 


e 


MapCoordinates 


MapCoordi  nates 


pointer  to  DateTimeGroup 


inter  to  unsioned  Ion 


short 


Where  Typedef  Declared 


DevelopmentiSIMNET  rlibmac: 
map.h 


DevelopmentiSIMNET  ilibmac; 
map.h 


DevelopmentiSIMNET  ilibmaci 
dta.h 


Standard  C  type. 


Standard  C  tvpe. 


Variable 


time 


tnptime 


distance 


Internal  Variables 


e 


unsioned  Ion 


unsioned  Ion 


IIII.MMIM.IM.M 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Function 


StrinoToMapCoordinates 


DistBetween2Pts 


GetDateTime 


Get  DTG 


DTGEIapsed 


Calls 


Where  Described 


See  Section  2.22.1.26.1. 


See  Section  2.22.1.23.2. 


Standard  Operatino  System  Utility  function  for  Macintosh. 


See  Section  2.22.1.15.4. 


See  Section  2.22.1.15.3. 


Called  B 


Function 

Where  Described 

Di  spl  ace  Di  spatch  E  ve  nt 

See  Section  2.13.8.10.5. 

Table  2.13«172:  ComputeETA  Information. 

2.13.8.10.19  comppct 

comp_pct  computes  a  percent  difference  between  two  times.  The  function  call  is 
comp_pct(timel,  time2).  Table  2.13-173  describes  the  parameters  used  by  this  function. 
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1  Called  By  I 

Function 

Where  Described 

DisplaceHattEvent 

See  Section  2.13.8.10.17. 

Table  2.13-173:  comp_pct  Information. 


2.13.8.10.20  UpdateDisplacement 

UpdateDisplacement  updates  the  displacement  table  entries.  The  function  call  is 
UpdateDisplacementO.  Table  2.13-174  describes  the  internal  variables  used  and  functions 
called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

time 

DateTimeGroup 

DevelopmentiSIMNET  ilibmac: 
dta.h 

i 

reqister  int 

Standard  C  type 

data 

pointer  to  DisplaceData 

Development  :SIMNET;MCC; 
SCCidisplace.h 

array  of  50  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

Get  DIG 

See  Section  2.22.1.15.4. 

NetworkArrived 

See  Section  2.13.8.10.22. 

UpdateScrollTable  Entry 

See  Section  2.22.1.31.1. 

LookupScrollTableEntry 

See  Section  2.22.1.24.1. 

ShowCaution 

See  Section  2.22.1.4.1. 

1  Called  By  1 

Function 

Where  Described 

MainEvenlLoop 

See  Section  2.13.8,15.3. 

Table  2.13-174:  UpdateDisplacement  Information. 


2.13.8.10.21  NetworkDispatched 

NetworkDispatched  sends  a  message  to  .  ie  host  indicating  the  user  has  requested  a  supply 
depot,  a  howitzer  battery,  or  that  one  of  the  command  posts  has  been  displaced.  This 
function  will  only  compile  if  VERSION  is  APPLETALK.  Otherwise,  it  is  a  dummy 
function.  The  function  call  is  NetworkDispatched(data).  Table  2.13-175  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

data 

register  pointer  to 

DisplaceData 

DevelopmentiSIMNET  :MCC: 
SCCidisplace.h 
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Variable 


artyReq 


depotsReq 


umcpReq 


Internal  Variables 


e 


SCCArtyDispatchRequest 


Where  Typedef  Declared 


Development:SIMNET  :MCC; 
SCC:SCC.h 


Development.SIMNET  ;MCC: 
SCCiSCC.h 


SCCUMCPOisplaceRequest  OevelopmentiSIMNET  ;MCC; 

SCC:SCC.h 


SCCDepotsRequest 


Function 


ATPPut 


Calls 


Where  Described 


See  Section  2.22.1.3.3. 


Called  B 


Function 

Where  Described 

Displace  Dispatch  Event 

See  Section  2.13.8.10.15. 

Table  2.13-175:  NetworkDispatched  Information. 

2.13.8.10.22  NetworkArrived 

NetworkArrived  is  called  when  the  user  halts  the  displacement  or  the  ETA  has  come  about. 
It  sends  a  message  to  the  host  indicating  the  new  location  of  the  unit.  This  function  will 
only  compile  if  VERSION  is  APPLETALK.  Otherwise,  it  is  a  dummy  function.  The 
function  call  is  NetworkArrived(data).  Table  2.13-176  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameter 


data 


Parameters 


pointer  to  DisplaceData 


Where  Typedef  Declared 


Development;SIMNET  :MCC: 
SCC:disDlace.n 


Variable 


ab 


artyReq 


TOCReq 


ALOCReq 


alocRole 


tocRole 


tocConfiouration 


GetGunAzimuth 


Internal  Variables 


e 


ABRecHandle 


pointer  to 

SCCArtyArriveRequest 


pointer  to  SCCTOCRequest 


pointer  to  SCCALOCRequest 


extern  char 


extern  char 


extern  char 


extern  array  of  int 


Where  Typedef  Declared 


Development;SlMNET  ;MCC; 
SCC:SCC.h 


DevelopmentiSIMNET  :MCC; 
SCC:SCC.h 


Development:SIMNET  :MCC; 
SCC:SCC.h 


Standard  C  type. 


Standard  C  tvoe. 


Standard  C  type. 


See  2.13.4.2.12. 


Calls 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manaqer  function  for  Macintosh. 

NewPtr 

Standard  Memory  Manaqer  function  for  Macintosh. 

GetGunAzimuth 

See  Section  2.13.4.2.12. 

SetUpATPRequest 

See  Section  2.22.1.3.2. 

ATPRequest 

Standard  Appletalk  Manaqer  function  for  Macintosh. 
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Called  Bv 

Function 

Where  Described 

DisplaceHaltEvent 

See  Section  2.13.8.10.17. 

UpdateDisplacement 

See  Section  2.13.8.10.20. 

Table  2.13-176:  NetworkArrived  Information. 


2.13.8.11  exercise. c 

Development:SIMNET:MCC:SCC:exercise.c 

exerciser  implements  the  user  interface  for  exercise  initialization  (i.e.,  choosing  a  terrain 
database,  selecting  participating  optional  elements,  etc.).  Table  2.13-177  describes  the 
variables  used  by  exercise.c. 


1  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

stanOiaiog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac; 
sequence. h 

mccRole  Dialog 

extern  DialogNodeDefn 

Development.'SIMNET  ;libmac; 
sequence. h 

selectTerrainDialog 

extern  DialogNodeDefn 

Development:SIMNET  ilibmac: 
sequence. h 

optElementI  Dialog 

extern  DialogNodeDefn 

DevelopmentiSIMNET  :libmac: 
sequence. h 

optElement2Dialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac; 
sequence. h 

coRoleDialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac: 
sequence. h 

startConfirmDialog 

extern  DialogNodeDefn 

Development:SIMNET  ilibmac: 
sequence. h 

initOverview  Dialog 

extern  DialogNodeDefn 

Development:SIMNET  ilibmac: 
sequence. h 

startFieldList 

pointer  to  array  of  FieldDefn 

Development.'SIMNET  :libmac: 
dialog,  h 

startDialog 

DialogNodeDefn 

Development;SIMNET  :libmac: 
sequence. h 

battleSchemeFields 

array  of  RBFieldDefn 

DevelopmentiSIMNET  rlibmac: 
dialog. h 

mccForceFields 

array  of  RBFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

mccRoleFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

mccRole  Dialog 

DialogNodeDefn 

DevelopmentiSIMNET  ilibmac: 
sequence. h 

selectTerrainFields 

array  of  RBFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

selectTerrainFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

selectTerrainDialog 

DialogNodeDefn 

DevelopmentiSIMNET  ilibmac: 
sequence. h 

elementsPermitted 

OptionalElements 

DevelopmentiSIMNET  iMCC: 
includeioptions.h 

(Table  2.13-177  is  continued  on  the  following  page.) 
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Variable 

Where  Typedef  Declared 

optElementt  FieldList 

pointer  to  array  of  FieldDefn 

Development;SIMNET  ilibmac: 
dialog. h 

optElementI  Dialog 

DialogNodeOefn 

Development;SIMNET  ilibmac: 
seguence.h 

optElement2Fields 

array  of  CBFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

optElement2HowBtrysField 

NumberFieldDefn 

DevelopmentiSIMNETilibmac: 

dialog.h 

optEiement2FjeldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

optElement2Dialog 

DialogNodeDefn 

DevelopmentiSIMNET  ilibmac: 
seguence.h 

coRoleFields 

array  of  RBFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

coRoleRectField 

RectFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

coRoleFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSlMNETilibmaci 

dialog.h 

coRoleDialog 

DialogNodeDefn 

DevelopmentiSIMNET  ilibmac: 
seguence.h 

startConfirmfieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNETilibmac: 

dialog.h 

startConfirmDialog 

DialogNodeDefn 

DevelopmentiSIMNET  ilibmac: 
seguence.h 

Table  2,13-177:  exercise.c  Variable  Information. 


2.13.8.11.1  LoadCannedExercise 

LoadCannedExercise  loads  canned  exercise  initialization  data.  The  function  call  is 
LoadCannedExercise().  Table  2.13-178  describes  the  functions  which  use  this  function. 


Called  By 

Function 

Where  Described 

LoadCannedData 

See  Section  2.13.8.15.2. 

Table  2.13-178:  LoadCannedExercise  Information. 

2.13.8.11.2  MCCRoleFetch 

MCCRoleFetch  labels  the  force  buttons  in  the  MCC  Role  dialog.  This  dialog  determines 
which  force  this  MCC  system  is  serving.  The  function  call  is  MCCRoleFetch(dialog). 
Table  2.13-179  describes  the  parameters  used  and  functions  called  using  this  function. 

_ _ Parameters _ _ 

Parameter _ Type _ Where  Typedef  Declared 

dialog  pointer  to  DialogState  Development:SIMNET:libmac: 

dialog. h 
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1  Calls  1 

Function 

Where  Described 

LabelForceButtons 

See  Section  2.22.1.16.1. 

Table  2.13>179:  MCCRoleFetch  Information. 

2.13.8.11.3  MCCRoleEvent 

MCCRoleEvent  is  called  when  a  battle  scheme  button  in  the  MCC  role  dialog  is  changed. 
The  labels  on  the  force  ID  buttons  are  adjusted  to  match.  The  function  call  is 
MCCRoleEvent(dialog,  itemNo).  Table  2.13-180  describes  the  parameters  used  and 
functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  ilibmac; 
dialoq.h 

itemNo 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

itemNo 

int 

resource  id  of  the  button 

Calls 

Function 

Where  Described 

LabelForceButtons 

See  Section  2.22.1.16.1. 

Table  2.13-180:  MCCRoleEvent  Information. 

2.13.8.11.4  SelectTerrainllpdate 

SelectTerrainUpdate  updates  the  terrain  displayed  for  the  current  selection.  The  function 
call  is  SelectTerrainUpdate(dialog).  Table  2.13-181  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Developmenf.SIMNET  :libmac: 
dialoq.h 

Calls 

Function 

Where  Described 

SetText 

See  Section  2.22.11.11.8. 

Called  By 

Function 

Where  Described 

SelectTerrainFetch 

See  Section  2.13.8.11.5. 

SelectTerrainEvent 

See  Section  2.13.8.11.6. 

Table  2.13-181:  SelectTerrainUpdate  Information. 
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2.13.8.11.5 


SelectT  errainFetch 


SelectTerrainFetch  reads  the  current  names  of  the  terrain  databases  into  the  dialog  radio 
buttons  for  display  to  the  user.  The  radio  buttons  are  loaded  with  actual  names  of  terrain 
databases.  The  exercise  area  comers  and  map  sheets  displayed  are  made  to  correspond  to 
the  current  selection.  The  function  call  is  SelectTerrainFetch(dialog).  Table  2.13-182 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac; 
dialog. h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

i 

int 

Standard  C  type. 

theltem 

Handle 

Development'.THINK  C: 

Mac  #inciudes;MacTypes.h 

box 

Rect 

DevelopmentiTHINK  C: 

Mac  #includes;MacTypes.h 

str 

array  of  256  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetDItem 

Standard  Dialoa  Manager  function  for  Macintosh. 

SetCTitle 

Standard  Control  Manager  function  for  Macintosh. 

HideControl 

Standard  Control  Manager  function  for  Macintosh. 

SelectTerrainUpdate 

See  Section  2.13.8.11.4. 

Table  2.13-182:  SelectTerrainFetch  Information. 

2.13.8.11.6  SelectTerrainEvent 

SelectTeirainEvent  is  called  when  a  button  in  the  select  terrain  dialog  is  pressed.  It 
determines  whether  the  data  entered  is  valid  and  updates  the  dialog.  The  item  number  of 
the  button  pressed  is  returned.  The  function  call  is  SelectTerrainEvent(dialog,  itemNo). 
Table  2.13-183  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  rlibmac; 
dialog. h 

itemNo 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

itemNo 

int 

resource  id  of  the  button 
pressed 

1  1 
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1  Calls  1 

Function 

Where  Described 

SelectTerrainUpdate 

See  Section  2.13.8.11.4. 

Table  2.13-183:  SelectTerrainEvent  Information. 

2.13.8.11.7  LoadOptionsPermitted 

This  routine  loads  the  permitted  options  for  the  selection  optional  elements  1  dialog.  The 
function  call  is  LoadOptionsPermitted().  Table  2.13-1 84  describes  the  functions  which  call 
this  function. 


1  Called  By  I 

Function 

Where  Described 

LoadCannedData 

See  Section  2.13.8.15.2. 

Table  2.13-184  LoadOptionsPermitted  Information. 
2.13.8.11.8  SetUpOptionalElements 

This  routine  sets  up  the  optional  elements.  To  start,  all  optional  elements  are  selected  (if 
permitted).  The  function  call  is  SetUpOptionalElements().  Table  2.13-185  describes  the 
functions  which  call  this  function. 


1  Called  By  I 

Function 

Where  Described 

Setup 

See  Section  2.13.8.17.1. 

Table  2.13-185:  SetUpOptionalElements  Information. 

2.13.8.11.9  PermitOptionalElements 

PermitOptionalElements  sets  the  optional  elements  permitted  to  options.  The  function  call 
is  PermitOptionalElements(options).  Table  2.13-186  describes  the  parameters  used  by  this 
function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

options 

pointer  to  OptionalElements 

Development:SIMNET  :MCC: 
includeioptions.h 

Called  By 

Function 

Where  Described 

DownloadOptions 

See  Section  2.13.8.6.4. 

Table  2.13-186:  PermitOptionalElements  Information. 
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2.13.8.11.10  OptElementlFetch 

OptElementl  Fetch  reads  the  current  values  of  the  permitted  options  into  the  optional 
elements  1  dialog  fields  to  display  to  the  user.  This  dialog  permits  the  choice  of  whether  to 
include  TOC,  Admin/Log  Center,  BN  HQ  Tank  Section,  Set  Pit,  or  Stealth  Jeep.  The 
function  call  is  OptElementl Fetch(state).  Table  2.13-187  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

state 

pointer  to  DialogState 

Development:SIMNET  ilibmac; 
dialoq.h 

Calls 

Function 

Where  Described 

DisableControl 

See  Section  2.22.1.7.1. 

Table  2.13-187:  OptElementlFetch  Information. 

2.13.8.11.11  OptElement2Fetch 

OptElement2Fetch  reads  the  current  values  of  the  permitted  options  into  the  optional 
elements  2  dialog  fields  to  display  to  the  user.  This  dialog  permits  the  choice  of  whether  to 
include  Fire  Support  Element,  Air  Liaison  Officer,  or  Combat  Service  Support.  The 
function  call  is  C)ptElement2Fetch (state).  Table  2.13-188  describes  the  parameters  used 
and  functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

state 

pointer  to  DialogState 

DevelopmentrSIMNET  :libmac: 
dialoq.h 

Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

theType 

int 

Standard  C  type. 

theltem 

Handle 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

theRect 

Rect 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

I  Calls  I 

Function 

Where  Described 

DisableControl 

See  Section  2.22.1.7.1. 

Table  2.13-188:  OptElement2Fetch  Information. 

2.13.8.11.12  OptElement2Event 

OptElement2Event  is  called  when  a  button  in  the  optional  elements  2  dialog  is  pressed.  It 
determines  whether  the  data  entered  is  valid.  It  throws  the  current  dialog  away  and  goes  to 
the  main  screen.  It  returns  the  item  number  of  the  button  pressed.  The  function  call  is 
OptElement2Event(dialog,  iteniNo)  Table  2. 1 3- 1 89  describes  the  parameters  used  and 
functions  called  using  this  function. 
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Parameters 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  OialogState 

DevelopmentiSIMNET  Mibrnac; 
dialog. h 

itemNo 


Variable 


theltem 


Internal  Variables 


e 


int 


Handle 


array  of  256  char 


Where  Typedef  Declared 


Standard  C  tvoe. 


DevetopmentiTHINK  C: 
Mac  #includes;MacTvpes.h 


OevelopmentTHINK  C: 
Mac  #includes:MacTypes.h 


Standard  C  type. 


Return  Values 


Return  Value 


ItemNo 


Type 


int 


mt 


Meaning _ 


do  nothing  upon  return  _ 


resource  id  of  button  pressed 


Calls 

Function 

Where  Described 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

SellText 

Standard  Dialog  Manager  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

SetText 

See  Section  2.22.1.11.8. 

Table  2.13-189:  OptEIement2Event  Information. 

2.13.8.11.13  CoRoleFetch 

CoRoleFetch  reads  the  current  values  of  the  company  roles  into  the  dialog  fields  to  display 
to  the  user.  The  company  role  dialog  allows  the  specification  of  each  company’s  role  in  the 
exercise.  The  function  call  is  CoRoleFetch(dialog).  Table  2.13-190  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


dialog 


Variable 


Parameters 


pointer  to  DialogStafe 


Internal  Variables 


e 


register  short 


Where  Typedef  Declared 


Development:SIMNET  :libmac: 
dialog. h 


Where  Typedef  Declared 


Standard  C  type. 


Function 


SetText 


DisableControl 


Calls 


Where  Described 


See  Section  2.22.1.11.8. 


See  Section  2.22.1.7.1. 


Table  2.13-190;  CoRoleFetch  Information. 
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2.13.8.11.14  UpIoadExerciseParameters 

UploadExerciseParameters  uploads  the  current  exercise  parameters  to  the  host.  This 
function  is  only  compiled  if  VERSION  is  APPLETALK.  Otherwise,  it  is  a  dummy 
function.The  function  call  is  UploadExerciseParametersQ.  Table  2.13-191  describes  the 
internal  variables  used,  errors  returned  and  functions  called  using  this  function. _ 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

req 

SCCExerciseRequest 

DevelopmentiSIMNET  :MCC: 
SCC:SCC.h 

rsp 

SCCExerciseResponse 

Development  :SIMNET  ;MCC: 
SCC:SCC.h 

errCode 

int 

Standard  C  type. 

i 

int 

Standard  C  type. 

Calls 


Function 

Where  Described 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

ATPPut 

See  Section  2.22.1.3.3. 

DownloadTerainMap 

See  Section  2.22.1.3.4. 

Called  By 

Function 

Where  Described 

StartConfirmEvent 

See  Section  2.13.8.11.5. 

Table  2.13-191:  UploadExerciseParameters  Information. 
2.13.8.11.15  StartConfirmEvent 


The  start  confirm  dialog  solicits  confirmation  before  starting  an  exercise.  If  the  OK  button 
was  pressed,  the  exercise  parameters  are  uploaded,  and  the  next  dialog  is  brought  up.  The 
item  number  of  the  button  pressed  is  returned.  The  function  call  is 
StartConfirmEvent(dialog,  itemNo).  Table  2.13-192  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  OialogState 

Development:SIMNET  ;libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

the  OK  button  was  pressed 

itemNo 

int 

resource  id  of  button  pressed 

Calls 

Function 

Where  Described 

UploadExerciseParameters 

See  Section  2.13.8.11.14. 

DialoqSeqNext 

See  Section  2.22.1.39.4. 

Table  2.13-192:  StartConfirmEvent  Information. 
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2.13.8.12  file.c 

Development:SIMNET;MCC;SCC:file.c 

file.c  contains  routines  for  creating  and  reading  Macintosh  files  holding  initialization 
parameters  for  gunnery  targets  and  vehicle  simulators.  Table  2.13-193  describes  the 
variables  used  by  file.c. 


1  Variables  1 

Variable 

Where  Tvoedef  Declared 

errSlr 

array  of  128  char 

Standard  C  type. 

Table  2.13-193:  file.c  Variable  Information 
2.13.8.12.1  LoadGunneryTargets 

LoadGunneryTargets  loads  the  gunnery  targets  from  a  prepared  file.  The  function  call  is 
LoadGunneryTargets().  Table  2.13-194  describes  the  internal  variables  used  and  functions 
called  using  this  function. 


I  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

where 

Point 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

theReply 

SFReply 

Development:THINK  C: 

Mac  #includes:StdFilePkg.h 

resCode 

OSErr 

DeveiopmentTHINK  C: 

Mac  #includes:MacTypes.h 

theinfo 

FInfo 

Development:THINK  C: 

Mac  #includes;FileMor.h 

theFile 

int 

Standard  C  type. 

theTypeList 

SFTypeList 

Development:THINK  C; 

Mac  #includes:StdFilePkg.h 

count 

long 

Standard  C  type. 

Calls 

Function 

Where  Described 

SFGetFile 

Standard  Standard  File  Package  function  for  Macintosh. 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

FSOpen 

Standard  File  Manager  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

WipeTarqetTable 

See  Section  2.13.8.12.5. 

ReadGunneryTargets 

See  Section  2.13.8.12.4. 

FSCIose 

Standard  File  Manager  function  for  Macintosh. 

FlushVol 

Standard  File  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

ProcessCommandShiftOption 

Sequence 

See  Section  2.13.8.15.4. 

Table  2.13-194:  LoadGunneryTargets  Information. 


365 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.13.8.12.2  SaveGunneryTargets 

SaveGunneryTargets  saves  the  gunnery  targets  in  a  file  selected  by  the  user.  The  function 
call  is  SaveGunneryTargetsO.  Table  2.13-195  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

where 

Point 

Development:THlNK  C: 

Mac  #includes;MacTypes.h 

theReply 

SFReply 

Development:THINK  C: 

Mac  #includes:StdFilePkg.h 

resCode 

OSErr 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

theinfo 

FInfo 

Development:THINK  C: 

Mac  #includes;FileMgr.h 

theFile 

int 

Standard  C  type. 

count 

Iona 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SFPutFile 

Standard  Standard  File  Packaqe  function  for  Macintosh. 

GetFInfo 

Standard  file  Manager  function  for  Macintosh. 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

Create 

Standard  File  Manager  function  for  Macintosh. 

FSOpen 

Standard  File  Manager  function  for  Macintosh. 

WriteGunnervTaraets 

See  Section  2.13.8.12.3. 

FSCIose 

Standard  File  Manager  function  for  Macintosh. 

FlushVol 

Standard  file  Manager  function  for  Macintosh. 

1  Called  By  I 

Function 

Where  Described 

ProcessCommandShiftOption 

Sequence 

See  Section  2.13.8.15.4. 

Table  2.13-195:  SaveGunneryTargets  Information. 
2.13.8.12.3  WriteGunneryTargets 


WriteGunneryTargets  writes  the  gunnery  target  information  in  the  file  indicated  by  theFile. 
The  function  call  is  WriteGunneryTargets(theFile).  Table  2.13-196  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

theFile 

int 

Standard  C  type. 

1  1 
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1  Internal  Variables  1 

Variable 

Where  Tvoedef  Declared 

resCode 

int 

Standard  C  type. 

gt 

TargetHandle 

Development;SlMNET;MCC; 

SCClarget.h 

astr 

array  of  128  char 

Standard  C  type. 

count 

lonq 

Standard  C  type. 

numTaraets 

int 

Standard  C  type. 

i 

int 

Standard  C  type. 

bytesOut 

int 

Standard  C  type. 

targetTableField 

extern  ScrollTableFieldDefn 

Development;SIMNET  :libmac; 
scroll,  h 

1  Calls  1 

Function 

Where  Described 

FSWrite 

Standard  File  Manager  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

SetEOF 

Standard  file  Manager  function  for  Macintosh. 

1  Called  By  1 

Function 

Where  Described 

SaveGunneryTargets 

See  Section  2.13.8.12.2. 

Table  2.13-196:  WriteGunneryTargets  Information. 
2.13.8.12.4  ReadGunneryTargets 


ReadGunneryTargets  reads  in  gunnery  target  information  from  theFile.  The  function  call  is 
ReadGunneryTargets(theFile).  Table  2.13-197  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

theFile 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

resCode 

int 

Standard  C  type. 

gt 

TargetHandle 

Developmenf.SlMNET  ;MCC: 
SCC:target.h 

old_gt 

TargetHandle 

Development:SIMNET  :MCC: 
SCC:target.h 

f 

GunneryTarget  Descriptor 

Development:SIMNET  :MCC: 
SCC:target.h 

astr 

array  of  128  char 

Standard  C  type. 

count 

long 

Standard  C  type. 

numTargets 

int 

Standard  C  type. 

i 

int 

Standard  C  type. 

newTargetNumber 

short 

Standard  C  type. 

targetTableField 

extern  ScrollTableFieldDefn 

DevelopmentiSIMNET  :libmac: 
scroll.h 

1  1 
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1  Calls  1 

Function 

Where  Described 

FSRead 

Standard  File  Manaqer  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

NewTaraet 

See  Section  2.13.6.2.1. 

InstallScrollTableEntry 

See  Section  2.22.1.21.1. 

UploadTarqet 

See  Section  2.13.6.2.5. 

Called  Bv 

Function 

Where  Described 

LoadGunneryTarqets 

See  Section  2.13.8.12.1. 

Table  2.13-197:  ReadGunneryTargets  Information. 
2.13.8.12.5  WipeTargetTable 


WipeTargetTable  removes  all  the  gunnery  target  table  entries.  The  function  call  is 
WipeTargetTable().  Table  2.13-198  describes  the  internal  variables  used  and  functions 
called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

i 

register  int 

Standard  C  type. 

targetByNumber 

extern  array  of  TargetHandle 

Development:SIMNET  :MCC; 
SCClarqet.h 

tgt 

register  pointer  to 

TargetHandle 

Development:SIMNET  ;MCC: 
SCC:tarqet.h 

Calls 

Function 

Where  Described 

RemoveTarqet 

See  Section  2.13.6.2.2. 

Called  By 

Function 

Where  Described 

LoadGunneryTarqets 

See  Section  2.13.8.12.1, 

Table  2.13-198:  WipeTargetTable  Information. 

2.13.8.12.6  LoadPresets 

LoadPresets  loads  in  combat  vehicle  descriptions  contained  in  a  prepared  file.  The  function 
call  is  LoadPresets().  Table  2.13-199  describes  the  internal  variables  used  and  functions 
called  using  this  function. 
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1  Internal  Variables  1 

Variable 

Where  Tvpedef  Declared 

where 

Point 

Development;THINK  C; 

Mac  #includes:MacTypes.h 

theReply 

SFReply 

Development:THINK  C: 

Mac  #includes:StdFilePka.h 

resCode 

OSErr 

DevelopmentiTHINK  C: 

Mac  #includes;MacTypes.h 

theinfo 

FInfo 

Development;THINK  C: 

Mac  #includes;FileMqr.h 

theFile 

int 

Standard  C  type. 

theTypeList 

SFTypeList 

DevelopmentiTHINK  C; 

Mac  #includes:StdFilePkg.h 

count 

Iona 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SFGetFile 

Standard  Standard  File  Packaqe  function  for  Macintosh. 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

FSOpen 

Standard  File  Manaqer  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

FSRead 

Standard  File  Manaqer  function  for  Macintosh. 

Flush  yol 

Standard  File  Manaqer  function  for  Macintosh. 

1  Called  By  I 

Function 

Where  Described  I 

ProcessCommandShiftOption 

Sequence 

See  Section  2.13.8.15.4. 

Table  2.13-199:  LoadPresets  Information. 

2.13.8.12.7  SavePresets 

SavePresets  saves  the  vehicle  descriptions  in  a  file  selected  by  the  user.  The  function  call  is 
SavePresetsO.  Table  2.13-200  describes  the  internal  variables  used  and  functions  called 
using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

where 

Point 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTvpes.h 

theReply 

SFReply 

DevelopmentiTHINK  Ci 

Mac  #includesiStdFilePka.h 

resCode 

OSErr 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTvpes.h 

theinfo 

FInfo 

DevelopmentiTHINK  Ci 

Mac  #includesiFileMqr.h 

theFile 

int 

St  indard  C  type. 

count 

lonq 

Standard  C  type. 

1  1 
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Function 


SFPutFile 


GetFInfo 


SetCursor 


ShowCaution 


Create 


FSOpen 


FSWrite 


SetEOF 


FSCIose 


Flushvol 


Calls 


Where  Described 


Standard  Standard  File  Package  function  for  Macintosh. 


Standard  File  Manager  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


See  Section  2.22.1.4.1. 


Standard  File  Manager  function  for  Macintosh. 


Standard  File  Manager  function  for  Macintosh. 


Standard  File  Manager  function  for  Macintosh. 


Standard  File  Manager  function  for  Macintosh. 


Standard  File  Manager  function  for  Macintosh. 


Standard  File  Manager  function  for  Macintosh. 


Called  B 


Function 

Where  Described 

ProcessCommandShiftOption 

Seguence 

See  Section  2.13.8.15.4. 

Table  2.13-200:  SavePresets  Information. 


2.13.8.13  init.c 

Development:SIMNET:MCC:SCC:init.c 

init.c  implements  the  initialization  overview  dialog,  presenting  a  choice  of  elements  to  be 
initialize  from  the  SCC.  Table  2.13-201  describes  the  variables  used  by  init.c. 


Variables 

Variable 

Type 

Where  Tvpedef  Declared 

initSelection 

char 

Standard  C  type. 

initTOCDialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac: 
sequence. h 

initALOCDialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac: 
seguence. h 

cssTypeDialog 

extern  DialogNodeDefn 

DevelopmentiSIMNET  ilibmac: 
sequence. h 

initArtyDialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac: 
sequence. h 

initCASDialog 

extern  DialogNodeDefn 

Development:SIMNET  :libmac: 
sequence. h 

passwordDialog 

extern  DialogNodeDefn 

Development:SlMNET  :libmac: 
sequence. h 

allocTable  Dialog 

extern  DialogNodeDefn 

Developmenf.SIMNET'.libmac: 
sequence. h 

placeSeiectDialog 

extern  DialogNodeDefn 

DevelopmentiSIMNET  :libmac: 
sequence. h 

cewAllocDialogOptionalEleme 

ntinfo 

array  of  OptionalElementInfo 

Development:SIMNET  :MCC; 
SCC:SCCMac.h 

initOverviewFields 

array  of  RBFieldDefn 

Development:SIMNET  ilibmac: 
dialog.h 

initOverviewFieldList 

pointer  to  array  of  FieldDefn 

Development:SIMNET  ;libmac: 
dialog.h 

initOverview  Dialog 

DialogNodeDefn 

Development;SIMNET:libmac: 
sequence. h 

Table  2.13-201:  init.c  Variable  Information. 
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2.13.8.13.1  InitOverviewFetch 

InitOverviewFetch  reads  the  initialization  overview  controls  into  the  dialog  fields  to  display 
to  the  user.  Controls  are  disabled  if  the  section  is  not  to  be  included,  or  if  it  is  already 
initialized.  The  function  call  is  InitOverviewFetch(dialog).  Table  2.13-202  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

Development  :S  I M  N  ET  :libmac : 
dialog. h 

Calls 

Function 

Where  Described 

DisableControl 

See  Section  2.22.1.7.1. 

Table  2.13-202:  InitOverviewFetch  Information. 

2.13.8.13.2  InitOverviewEvent 

InitOverviewEvent  is  called  when  a  button  in  the  initialization  overview  dialog  is  pressed. 
Controls  of  the  selected  dialog  are  enabled  (unless  the  Help  or  Goo  buttons  were  pressed). 
The  item  number  of  the  button  pressed  is  returned.  The  function  call  is 
InitOverviewEvent(dialog,  itemNo).  Table  2.13-203  describes  the  parameters  used  and 
functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  ;libmac: 
dialoq.h 

itemNo 

int 

Standard  C  type. 

I  Return  Values  I 

Return  Value 

Type 

Meaning 

itemNo 

int 

resource  id  of  button  pressed 

I  Calls  I 

Function 

Where  Described 

EnableControl 

See  Section  2.22.1.7.2. 

Table  2.13-203;  InitOverviewEvent  Information. 

2.13.8.13.3  InitOverviewBranch 

InitOverviewBranch  is  used  when  there  is  a  list  of  items  to  select.  It  checks  the  type  of 
item  selected  and  brings  up  the  next  dialog,  depending  on  the  item  type.  Returns  a  handle 
to  the  next  dialog  to  pop  up.  The  function  call  is  InitOverviewBranch(dialog).  Table  2.13- 
204  describes  the  parameters  used  and  functions  called  using  this  function. 
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1  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

Development;SIMNET  :libmac: 
dialog. h 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

&allocTableDialog 

pointer  to  DialogNodeDefn 

handle  of  alloc  table  dialog 

&placeSelectDjalog 

pointer  to  DialogNodeDefn 

handle  of  the  place  select 
dialog 

pointer  to  DialogNodeDefn 

handle  of  the  password  dialog 

&bmOverviewDialog 

pointer  to  DialogNodeDefn 

handle  of  the  bm  overview 
dialog 

optionalElementlnfo[initSelect 

ionl.seq 

pointer  to  DialogNodeDefn 

handle  of  the  optional  element 
info  dialogs 

Table  2.13-204:  InitOverviewBranch  Information. 

2.13.8.14  lock.c 

Development:SIMNET:MCC;SCC:lock.c 

lock.c  implements  a  BatdeMaster-controlled  locking  of  the  SCC  Macintosh.  When  Cmd- 
Shift-Opt-L  is  pressed,  a  dialog  is  displayed  indicating  that  the  console  is  locked.  All 
subsequent  keystrokes  and  mouse  clicks  are  ignored,  except  another  Cmd-Shift-Opt-L, 
which  causes  the  dialog  to  be  removed.  Table  2.13-205  describes  the  varibles  used  by 
lock.c. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

consoleLockDialog 

DialogRr 

DevelopmentiTHINK  C: 

Mac  #includes:DialogMgr.h 

Table  2.13-205:  lock.c  Variable  Information. 

2.13.8.14.1  ToggleConsoleLock 

ToggleConsoleLock  locks  and  unlocks  the  console.  The  function  call  is 
ToggleConsoleLockO.  Table  2.13-206  describes  the  functions  called  using  this  function. 


i  Calls  1 

1  Function 

Where  Described 

1  II 1  1 1  II II 1  ■— 1 

Standard  Dialog  Manager  function  for  Macintosh. 

Standard  Dialog  Manager  function  for  Macintosh. 

1  SetWRefCon 

Standard  Window  Manager  function  for  Macintosh. 

1  Called  Bv  1 

Function 

Where  Described 

ProcessCommandShiftOption 

Sequence 

See  Section  2.13.8.15.4. 

Table  2.13-206:  ToggleConsoleLock  Information. 
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2.13.8.14.2  LockDialogEvent 

LockDialogEvent  is  called  when  the  lock  dialog  gets  an  event.  The  function  call  is 
LockDialogEvent(window,  theEvent).  Table  2.13-207  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

window 

WindowPtr 

DevelopmentTHINK  C: 

Mac  #includes;WindowMqr.h 

theEvent 

pointer  to  EventRecord 

DevetopmentTHINK  C: 

Mac  #includes;EventMqr.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

itemHit 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

DialoqSelect 

Standard  Dialoq  Manaqer  function  for  Macintosh. 

SysBeep 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

Table  2.13-207:  LockDialogEvent  Information. 

2.13.8.15  main.c 

Development:SIMNET:MCC:SCC:main.c 

main.c  contains  the  SCC  application's  program  entry  point  and  main  event  loop. 

2.13.8.15.1  main 

main  is  the  program  entry  point  for  the  SCC  application.  The  function  call  is  main().  Table 
2.13-208  describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

startDialog 

extern  DialogNodeDefn 

Development:SIMNET  ;libmac: 
sequence. h 

Calls 

Function 

Where  Described 

Setup 

See  Section  2.13.8.17.1. 

LoadCannedData 

See  Section  2.13.8.15.2. 

ProcessRequest 

See  Section  2.13.8.6.1. 

SetUpAppleTalk 

See  Section  2.22.1.3.1. 

DownloadTerrain 

See  Section  2.13.8.6.3. 

DownloadOptions 

See  Section  2.13.8.6.4. 

DownloadSimulators 

See  Section  2.22.2.3.1. 

MenuBarTitle 

See  Section  2.22.1.43.1. 

InstallClock 

See  Section  2.22.1.6.4. 

Start  DialoqSeq 

See  Section  2.22.1.39.1. 

MainEventLoop 

See  Section  2.13.8.15.3. 

Table  2.13-208:  main  Information. 
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2.13.8.15.2  LoadCannedData 

LoadCannedData  loads  canned  data  into  the  data  structures.  This  function  is  only  compiled 
if  VERSION  is  FULDAGAP.  The  function  call  is  LoadCannedDataQ.  Table  2.13-209 
describes  the  functions  called  using  this  function. 


Calls 

Function 

Where  Described 

LoadCannedExercise 

See  Section  2.13.8.11.1. 

LoadOptionsPermitted 

See  Section  2.13.8.11.7. 

LoadCannedCSS 

See  Section  2.13.3.1.1. 

LoadCannedTOC 

See  Section  2.13.1.2.1. 

LoadCannedALOC 

See  Section  2.13.1.1.1. 

LoadCannedCAS 

See  Section  2.13.4.1.1. 

LoadCannedFSE 

See  Section  2.13.4.2.1. 

LoadCannedSimulators 

See  Section  2.22.2.6.1. 

Called  B 


Function 

Where  Described 

main 

See  Section  2.13.8.15.1. 

Table  2.13-209:  LoadCannfc.'*Data  Information. 


2.13.8.15.3  MainEventLoop 

MainEventLoop  processes  events  off  of  the  queue.  The  function  call  is  MainEventLoopO. 
Table  2.13-210  describes  the  internal  variables  used  and  functions  called  using  this 
function, 

_  Internal  Variables  _ 

Variable _ Type  I  Where  Typedef  Declared 

passwordDialog  extern  DialogNodeDefn  Development:SIMNET:libmac; 

_ sequence.h _ 

myEvent  EventRecord  DevelopmentTHINK  C: 

Mac  #includes:EventMgr.h 


Calls 

Function 

Where  Described 

SystemTask 

Standard  Desk  Manaqer  function  for  Macintosh. 

UpdateClock 

See  Section  2.22.1.6.2. 

GetNext  Event 

Standard  Toolbox  Event  Manaqer  function  for  Macintosh. 

ProcessCommandShiftOption 

Sequence 

See  Section  2.13.8.15.4. 

WindowEvent 

See  Section  2.22.1.46.2. 

NetworkEventHandler 

See  Section  2.22.1.3.5, 

UpdateDisplacement 

See  Section  2.13.8.10.20. 

Called  B 


Function 

Where  Described 

main 

See  Section  2.13.8.15.1. 

Table  2.13-210:  MainEventLoop  Information. 
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2.13.8.15.4  ProcessCommandShiftOptionSequence 

ProcessCommandShiftOptionSequence  determines  what  function  to  execute  depending  on 
which  Cmd-Shift-C)pt-<letter>  combination  has  been  pressed,  keypressed  is  the  letter  that 
is  pressed  at  the  same  time  as  the  Command,  Shift  and  Option  keys.  The  function  call  is 
ProcessCommandShiftOptionSequence(keyPressed).  Table  2.13-211  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

keyPressed 

register  int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

disbUnitSelection 

extern  int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SavePresets 

See  Section  2.13.8.12.7. 

SetCursor 

Standard  Quickdraw  function  for  Macintosh. 

Load  Presets 

See  Section  2.13.8.12.6. 

SaveGunneryT  arqets 

See  Section  2.13.8.12.2. 

ToaaleConsoleLock 

See  Section  2.13.8.14.1. 

ATPCIoseSocket 

Standard  Appletalk  Manager  function  for  Macintosh. 

ExitToShell 

Standard  Segment  Loader  function  for  Macintosh. 

LoadGunnervTarqets 

See  Section  2.13.8.12.1. 

ShowVersions 

See  Section  2.22.1.44.1. 

CompleteDisplacement 

See  Section  2.13.8.10.1. 

1  Called  Bv  1 

1  Function 

Where  Described 

See  Section  2.13.8.15.3. 

Table  2.13-211:  ProcessCommandShiftOptionSequence  Information. 


2.13.8.16  master. c 

Development:SlMNET:MCC:SCC:master.c 

master.c  implements  the  BattleMaster  overview  dialog,  presenting  a  choice  of  activities  for 
the  BattleMaster.  Table  2.13-212  describes  the  variables  used  by  master.c. 
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1  Variables  1 

Variable 

Where  Tvpedef  Declared 

passwordBuffer 

array  of  bmPasswordLength 
char 

Standard  C  type. 

passwordCancelField 

PushButtonFieidDefn 

Development:SIMNET  :libmac; 
dialoa.h 

passwordField 

TextFieldOefn 

DevelopmentrSIMNET  :libmac: 
dialog. Ii 

passwordFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  :libmac; 
dialoa.h 

passwordDialog 

OialogNodeDefn 

OevelopmentiSIMNET  rlibmac; 
sequence. h 

bmSelection 

char 

Standard  C  type. 

stopDialog 

extern  OialogNodeDefn 

Development;SIMNET  :libmac; 
sequence. h 

reconstDiaiog 

extern  OialogNodeDefn 

Development:SIMNET  :libmac; 
sequence. h 

moreSortiesDialog 

extern  OialogNodeDefn 

DevelopmentrSIMNET  rlibmac; 
sequence. h 

displaceDialog 

extern  OialogNodeDefn 

DevelopmentrSIMNET  rlibmac; 
sequence. h 

bmFunctions 

array  of  numberBMFunctions 
struct  bmFunctions 

bmOverviewFields 

array  of  RBFieldDefn 

DevelopmentrSIMNET  rlibmac; 
dialog. h 

bmOverviewFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentrSIMNET  rlibmac; 
dialog. h 

bmOverviewDialog 

OialogNodeDefn 

DevelopmentrSIMNET  rlibmac; 
sequence. h 

StopFieldList 

p  winter  .o  array  of  FieldDefn 

DevelopmentrSIMNET  rlibmac; 
dialoq.h 

StopDialog 

OialogNodeDefn 

DevelopmentrSIMNET  rlibmac; 
sequence. h 

Table  2.13-212:  master.c  Variable  Information. 

2.13.8.16.1  PasswordFetch 

PasswordFetch  reads  the  password  buffer  into  the  Password  dialog  fields.  The  function 
call  is  PasswordFetch(dialog).  Table  2.13-213  describes  the  parameters  used  by  tliis 
function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentrSIMNET  rlibmac; 
dialoq.h 

Table  2.13-213:  PasswordFetch  Information. 
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2.13.8.16.2  Passwords  vent 

PasswordEvent  is  called  when  a  button  in  the  password  dialog  is  pressed.  The  function 
call  is  PasswordEvent(dialog,  itemNo).  Table  2.13-214  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameters 


Parameter 


dialog 


ItemNo 


Variable 


Return  Value 


itemNo 


Function 


ShowCaution 


SellText 


IE173 


pointer  to  DialogState 


Internal  Variables 


e 


reoister  pointer  to  char 


reoister  pointer  to  char 


IE273 


Where  Tvpedef  Declared 


Development:SIMNET:libmac; 

dialOQ.h 


Standard  C  type. 


Where  Tvpedef  Declared 


standard  C  type. 


Return  Values 


Type 


int 


int 


Meaning 


do  nothing  upon  return 


resource  id  of  button  pressed 


Calls 


Where  Described 


See  Section  2.22.1.4.1. 


Standard  Dialoq  Manager  function  for  Macintosh. 


Table  2.13-214:  PasswordEvent  Information. 


2.13.8.16.3  BMOverviewFetch 

BMOverviewFetch  reads  the  selections  and  sets  up  the  controls  for  the  battle  master 
overview  dialog  fields  to  display  to  the  user.  The  function  call  is 
BMOverviewFetch(dialog).  Table  2.13-215  describes  the  parameters  used  and  functions 
called  using  this  function. 


Parameter 


dialog 


Variable 


supplvDepotsInited 


Parameters 


pointer  to  DialogState 


Internal  Variables 


int 


extern  char 


Where  Tvpedef  Declared 


Development:SIMNET  :libmac: 
dialoq. h 


Where  Tvpedef  Declared 


Standard  C  type. 


Standard  C  type. 


Calls 


Function  Where  Described 


DisableControl  See  Section  2.22.1.7.1. 


Table  2.13-215:  BMOverviewFetch  Information. 
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2.13.8.16.4  BMOverviewEvent 


BMOverviewEvent  is  called  when  a  button  in  the  battle  master  overview  dialog  is  pressed. 
The  item  number  of  the  button  pressed  is  returned.  The  function  call  is 
BMOverviewEvent(dialog,  itemNo).  Table  2.13-216  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameter 


dialog 


itemNo 


Parameters 


pointer  to  DialogState 


Where  Tvpedef  Declared 


Development:SIMNET  ;libmac: 
dialoa.h 


Standard  C  tvoe. 


Variable 


theltem 


Internal  Variables 


e 


int 


Handle 


Where  Tvpedef  Declared 


Standard  C  type. 


DevelopmentTHINK  C: 
Mac  #includes;MacTvpes.h 


DevelopmentiTHINK  C: 
Mac  #includes;MacTvpes.h 


Return  Value 


0 


itemNo 


Return  Values 


Type 


int 


int 


Meaning 


do  nothing  upon  return 


resource  id  of  button  pressed 


Function 


ShowTarqetTable 


GetDItem 


SetCtIValue 


DisableControl 


DialogSeqNext 


HiliteControl 


Calls 


Where  Described 


See  Section  2.13.6.4.2. 


Standard  Dialoo  Manaqer  function  for  Macintosh. 


Standard  Control  Manaqer  function  for  Macintosh. 


See  Section  2.22.1.7.1. 


See  Section  2.22.1.39.4. 


Standard  Control  Manaqer  function  for  Macintosh. 


Table  2.13-216:  BMOverviewEvent  Information. 
2.13.8.16.5  StopEvent 


StopEvent  is  called  when  a  button  in  the  stop  dialog  is  pressed.  It  returns  the  item  number 
of  the  button  pressed.  The  function  call  is  StopEvent(dialog,  itemNo).  Table  2.13-217 
describes  the  parameters  used,  errors  returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  ;libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

itemNo 

int 

resource  id  of  button  pressed 
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Function 


ATPPut 


ATPCioseSocket 


Restart 


Calls 


Where  Described 


See  Section  2.22.1.3.3. 


letalk  Manaoer  function  for  Macintosh. 


Standard  Ooeratino  System  Utility  function  for  Macintosh. 


Table  2.13-217:  StopEvent  Information. 

2.13.8.17  setup.c 

Development:SIMNET:MCC:SCC:setup.c 

setup.c  initializes  the  SCC  application  at  start-up. 

2.13.8.17.1  Setup 

SetUp  initializes  the  SIMNET  Control  Console  application.  The  toolbox  is  initialized,  the 
SIMNET  Resources  and  SCC  Picture  Files  are  opened,  the  Help  manager  is  initialized,  and 
storage  is  allocated  for  the  dialog  states.  The  function  call  is  SetUpQ.  Table  2.13-218 
describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

errCode 

int 

Standard  C  type. 

port 

GrafPort 

Deyelopment:THINK  C: 

Mac  #includes:Quickdraw.h 

finalTicks 

lonq 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

InitToolbox 

See  Section  2.22.1.20.1. 

Zoomlnit 

See  Section  2,22.1.47.1. 

GetCursor 

Standard  Quickdraw  function  for  Macintosh. 

OpenResFile 

Standard  Resource  Manager  function  for  Macintosh. 

MenuBarTitle 

See  Section  2.22.1.43.1. 

Delay 

Standard  Operating  System  Utility  function  for  Macintosh. 

ExitToShell 

Standard  Segment  Loader  function  for  Macintosh. 

DeeoShit 

See  Section  2.22.1.8.2. 

helpinit 

See  Section  2.22.1.19.1. 

SystemFailure 

See  Section  2.22.1.8,1. 

NewRr 

Standard  Memory  Manager  function  for  Macintosh. 

OpenPort 

Standard  Quickdraw  function  for  Macintosh. 

SetUpAlloc 

See  Section  2.13.2.1.1. 

SetUpDisplacement 

See  Section  2.13.8.10.13. 

SetUpOptionalElements 

See  Section  2.13.8.11.8. 

SetUpPlace 

See  Section  2.13.2.2.1. 

SetUpTarqets 

See  Section  2.13.6.4.1. 

SetUpTrucks 

See  Section  2.13.3.4.1. 

ClosePort 

Standard  Quickdraw  function  for  Macintosh. 

SetUpSimulators 

See  Section  2.22.2.9.1. 
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1  Called  By  1 

Function 

Where  Described 

main 

See  Section  2.13.8.15.1. 

Table  2.13-218:  SetUp  Information. 


2.13.8.18  string.c 

Development:SIMrfeT:MCC:SCC:string.c 

string.c  contains  a  routine  for  copying  Pascal-format  strings. 

2.13.8.18.1  Pstrcpy 

Pstrcpy  copies  a  Pascal  string  src  to  another  Pascal  stnngdest  and  returns  a  pointer  to  the 
result.  The  function  call  is  Pstrcpy(dest,  src).  Table  2.13-219  describes  the  parameters 
used  and  functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dest 

reqister  pointer  to  char 

Standard  C  type. 

src 

reqister  pointer  to  char 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

len 

reqister  int 

Standard  C  type. 

i 

reqister  int 

Standard  C  type. 

result 

register  pointer  to  char 

Standard  C  type. 

I  Return  Values  I 

Return  Value 

Meaning 

result 

pointer  to  char 

pointer  to  Pascal  string  copies 
into  dest. 

Table  2.13-219: 


Pstrcpy  Information. 
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2.14  The  Place  (Placement)  Console 


Place  (Placement)  Console 
1.14 


Place 

Console 

DefinKions 

1.14.1 


-Place.h 

1.14.1.1 


Place 

Console 

Software 

1.14.2 


-  atalk.c 
1.14.2.1 


Appearance 
of  User 
Interface 
1.14.3 


Place  Pictures 
1.4.3.1 


-PlaceMac.h 

1.14.1.2 


-dlalog.c 

1.14.2.2 


-version.h 

1.14.1.3 


-main.c 

1.14.2.3 


.^ata.c 

1.14.1.4 


-place.c 

1.14.2.4 


j'esource.h 

1.14.1.5 


-setup.c 

1.14.2.5 


Figure  2.14-1:  Place  (Placement)  Console  Structure. 


2.14.1  Place  Console  Definitions 


2.14.1.1  Place.h 

Development:SIMNET:MCC:Place:Place.h 

Place.h  defines  the  representation  of  information  communicated  between  the  Place 
Macintosh  application  and  the  MCC  host. 
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2.14.1.2  PlaceMac.h 

Development:SIMNET:MCC:Place:PlaceMac.h 

PlaceMac.h  defines  types,  constants  and  routines  used  within  the  Place  Macintosh 
application.  Table  2.14-1  describes  the  variables  used  by  PlaceMac.h. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

options 

OptionalElements 

Development:SIMNET  :MCC: 
include  ;options.h 

seqDialog 

extern  pointer  to 
OialoqSeaState 

Development:SIMNET  :libmac: 
sequence. h 

watchCursorHandle 

extern  CursHandle 

Development:THINK  C; 

Mac  #includes:Quickdraw.h 

Table  2.14-1:  PlaceMac.h  Variable  Information. 


2.14.1.3  version. h 

Development:SIMNET:MCC:Place:version.h 

version.h  defines  constants  that  determine  which  version  of  the  Place  application  is 
compiled. 

2.14.1.4  data.c 

Development:SIMNET:MCC:Place:data.c 


data.c  defines  various  data  structures  used  by  the  Place  application.  Table  2.14-2  describes 
the  variables  used  by  data.c. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

application 

pointer  to  char 

Standard  C  type. 

authors 

pointer  to  char 

Standard  C  type. 

copyriqht 

pointer  to  char 

Standard  C  type. 

options 

OptionalElements 

DevelopmentiSIMNET  ;MCC; 
include:options.h 

seqDialog 

pointer  to  DialogSeqState 

DevelopmentiSIMNET  ilibmac: 
sequence. h 

watchCursorHandle 

CursHandle 

DevelopmentTHINK  C: 

Mac  #includes:Quickdraw.h 

Table  2.14-2;  data.c  Variable  Information. 

2.14.1.5  resource. h 

Development:SIMNET:MCC:Place:resource.h 

resource. h  defines  the  numbers  of  the  resources  present  in  the  Place  Pictures  resource  file. 
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2.14.2  Place  Console  Software 


2.14.2.1  atalk.c 

Development:SIMNET:MCC:Place:atalk.c 

atalkx  contains  routines  supporting  AppleTalk  communication  between  the  Place 
Macintosh  application  and  the  MCC  host  process. 

2.14.2.1.1  ProcessRequest 


ProcessRequest  processes  a  request  received  from  the  MCC  host.  The  function  call  is 
ProcessRequest(hdl).  Table  2.14-3  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

hdl 

Handle 

DeyelopmentTHINK  C: 

Mac  #includes;MacTvpes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

P 

register  Ptr 

DeyelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

errCode 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

SetDateTime 

Standard  Operatina  System  Utility  function  for  the  Macintosh. 

ATPResponse 

Standard  Appletalk  Manaoer  function  for  the  Macintosh. 

Restart 

Standard  Operatina  System  Utility  function  for  the  Macintosh. 

SimulatorAlloced 

See  Section  2.14.2.4.8. 

ProcessSimPlacedRequest 

See  Section  2.22.2.3.4. 

SimulatorPlaced 

See  Section  2.14.2.4.9. 

ATPError 

See  Section  2.22.1.3.3. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.14.2.3.1. 

Table  2.14-3:  ProcessRequest  Information. 


2.14.2.1.2  DownloadParameters 

DownloadParameters  downloads  information  about  grid  zones,  participating  units,  and 
simultors  from  the  host  at  the  start  of  an  exercise.  The  function  call  is 
DownloadParameters().  Table  2.14-4  describes  the  internal  variables  used  and  functions 
called  using  this  function. 
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I  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

rsp 

PlaceStartResponse 

Development:SIMNET  :MCC: 
Place:  Place,  h 

Calls 

Function 

Where  Described 

DownloadTerrainMap 

See  Section  2.22.1.3.4. 

ATPPut 

See  Section  2.22.1.3.3. 

DownloadSimulators 

See  Section  2.22.2.3.1. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.14.2.3.1. 

Table  2.14-4:  DownloadParameters  Information. 


2.14.2.2  dialog. c 

Development:SIMr^T:MCC:Place;dialog.c 


dialog.c  contains  miscellaneous  routines  supporting  dialog  implementations.  Table  2.14-5 
describes  the  variables  used  by  dialog.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

table  RowRext 

Rect 

Development:THINK  C; 

Mac  #includes:MacTvpes.h 

popUpWindow 

WindowPtr 

Development;THINK  C: 

Mac  #includes:WindowMqr.h 

Table  2.14-5:  dialog.c  Variable  Information. 


2.14.2.2.1  ZoomUpFromTableEntry 

ZoomUpFromTableEntry  zooms  from  a  row  in  a  table,  given  by  box,  to  a  pop  up  window. 
The  function  call  is  ZoomUpFromTableEntry(box).  Table  2.14-6  describes  the  parameters 
used  and  functions  called  using  this  function. 


_ _ Calls _ 

Function _ Where  Described _ 

ZoomToWindow _ See  Section  2.22.1. 47.4. _ 

^howWindow  Standard  Window  Manager  function  for  the  Macintosh. 
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1  Called  Bv  1 

Function 

Where  Described 

PlaceTableSelect 

See  Section  2.14.2.4.6. 

Table  2.14-6:  ZoomUpFromTableEntry  Information. 

2.14.2.2.2  ZoomDownToTableEntry 

ZoomDownToTableEntry  zooms  from  a  pop  up  window  to  a  row  within  a  table.  The 
function  call  is  ZoomDownToTableEntry().  Table  2.14-7  describes  the  functions  called  by 
this  function. 


1  Calls  1 

Function 

Where  Described 

HideWindow 

Standard  Window  Manaaer  function  for  the  Macintosh. 

ZoomToWindow 

See  Section  2.22.1.47.4. 

Called  Bv 

Function 

Where  Described 

PlaceCompIete 

See  Section  2.14.2.4.5. 

Table  2.14-7:  ZoomDownToTableEntry  Information. 

2.14.2.3  main.c 

Development:SIMNET:MCC:Place:main.c 

main.c  contains  the  Place  application's  program  entry  point  and  main  event  loop. 

2.14.2.3.1  main 

main  is  the  program  entry  point  for  the  Place  console  application.  The  function  call  is 
mainQ.  Table  2.14-8  describes  the  internal  variables  used  and  functions  called  using  this 
function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

placeSelectDialog 

extern  DialogNodeDefn 

DevelopmentiSIMNET  :libmac; 
sequence. h 

Calls 

Function 

Where  Described 

Setup 

See  Section  2.14.2.5.1. 

LoadCannedTerrainMap 

See  Section  2.14.2.3.2. 

LoadCannedSimulators 

See  Section  2.22.2.6.1. 

ProcessRequest 

See  Section  2.14.2.1.1. 

SetUpAppleTalk 

See  Section  2.22.1.3.1. 

DownloadParameters 

See  Section  2.14.2.1.2 

MenuBarTitle 

See  Section  2.22.1.43.1 

InstallClock 

See  Section  2.22.1.6.4. 

StartDialoqSeq 

See  Section  2.22.1.39.1. 

MainEventLoop 

See  Section  2.14.2.3.3. 

Table  2.14-8:  main  Information. 
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2.14.2.3.2  LoadCannedTerrainMap 

LoadCannedTerrainMap  loads  the  terrain  map  structure  with  dummy  data  for  the  demo 
version  of  the  program.  The  function  is  only  compiled  if  VERSION  is  FULDAGAP.  The 
function  call  is  Lx)adCannedTerrainMap().  Table  2.14-9  describes  the  functions  calling 
this  function. 


1  Called  Bv  1 

Function 

Where  Described 

main 

See  Section  2.14.2.3.1. 

Table  2.14*9:  LoadCannedTerrainMap  Information. 

2.14.2.3.3  MainEventLoop 

MainEventLoop  processes  events  off  the  queue.  The  function  call  is  MainEventLoopO. 
Table  2.14-10  describes  the  internal  variable  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

myEvent 

EventRecord 

DevelopmentrTHINK  C: 

Mac  #includes:EventMar.h 

Calls 

Function 

Where  Described 

SvstemTask 

Standard  Desk  Manaaer  function  for  the  Macintosh. 

UpdateClock 

See  Section  2.22.1.6.2. 

GetNextEvent 

Standard  Toolbox  Event  Manaaer  function  for  the  Macintosh. 

NetworkEventHandler 

See  Section  2.22.1.3.5. 

ATPCIoseSocket 

Standard  Appletalk  Manaaer  function  for  the  Macintosh. 

ExitToShell 

Standard  Seament  Loader  function  for  the  Macintosh. 

ShowVersions 

See  Section  2.22.1.44.1. 

WindowEvent 

See  Section  2.22.1.46.2, 

Called  By 

Function 

Where  Described 

main 

See  Section  2.14.2.3.1. 

Table  2.14*10:  MainEventLoop  Information. 

2.14.2.4  place. c 

Development:SIMNT;T:MCC;Place:place.c 

place.c  implements  the  user  interface  for  placing  vehicle  simulators.  Table  2.14-1 1 
describes  the  variables  used  by  place.c. 
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1  Variables  I 

Variable 

Where  Tvpedef  Declared 

placeCompany 

char 

Standard  C  type. 

placeTable  Dialog 

extern  DialogNodeDefn 

Development;SIMNET  ilibmac; 
sequence. h 

placeTableField 

extern  ScrollTableFietdDefn 

DevelopmentrSIMNET  :libmac: 
scroll. h 

placeColumns 

extern  array  of 

ScrollT  ableColumnDefn 

Deyelopment;SIMNET  :libmac: 
scroll.h 

placeSelectFields 

array  of  RBFieldDefn 

Development:SIMNET  :libmac: 
dialog. h 

placeSelectFieldList 

pointer  to  array  of  FieldDefn 

Deyelopment;SIMNET  :libmac: 
dialog,  h 

placeSelectDialog 

DialogNodeDefn 

DevelopmentiSIMNET  rlibmac; 
sequence. h 

placeColumns 

array  of 

ScrollTableColumnDefn 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

placeTableField 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

placeTable  FieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

placeTableOialog 

DialogNodeDefn 

DevelopmentiSIMNET  ilibmaci 
sequence. h 

Table  2.14-11:  place.c  Variable  Information. 
2.14.2.4.1  SetUpPlace 

SetUpPlace  sets  up  the  dialog  for  placing  vehicles.  The  function  call  is  SetUpPlaceQ. 
Table  2.14-12  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

TextFont 

Standard  Quickdraw  function  for  the  Macintosh. 

TextSize 

Standard  Quickdraw  function  for  the  Macintosh. 

StringWidth 

Standard  Quickdraw  function  for  the  Macintosh. 

Called  By 

Function 

Where  Described 

Setup 

See  Section  2.14.2.5.1. 

Table  2.14-12:  SetUpPlace  Information. 
2.14.2.4.2  PlaceSelectFetch 


PlaceSelectFetch  reads  the  participating  organizational  units  into  the  Place  Select  dialog  to 
display  to  the  user.  The  Place  Select  dialog  allows  the  user  to  select  the  company  whose 
simulators  are  to  be  placed.  The  routine  also  disables  radio  buttons  for  optional  elements 
not  included  in  the  exercise  and  for  organizational  units  which  are  not  participating.  The 
function  call  is  PlaceSelectFetch(dialog).  Table  2.14-13  describes  the  parameters  used  and 
function  called  using  this  function. 
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1  Parameters  | 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Oevelopment:SIMNET  ilibmac; 
dialog. h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

DisableControl 

See  Section  2.22.1.7.1. 

Table  2.14-13:  PlaceSelectFetch  Information. 


2.14.2.4.3  PlaceSelectEvent 

PlaceSelectEvent  is  called  when  a  button  in  the  Place  Select  dialog  is  pressed.  When  a 
valid  button  is  pressed,  the  routine  enables  control  of  the  Go  button.  The  item  number  of 
the  button  pressed  is  returned.  The  function  call  is  PlaceSelectEvent(dialog,  itemNo). 
Table  2.14-14  describes  the  parameters  used  and  function  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  :libmac; 
dialog.h 

itemNo 

int 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Meaning 

itemNo 

int 

resource  id  of  the  button  hit 

1  Calls  1 

Function 

Where  Described 

EnableControl 

See  Section  2.22.1.7.2. 

Table  2.14-14:  PlaceSelectEvent  Information. 


2.14.2.4.4  PlaceTableFetch 

PlaceTableFetch  reads  the  selected  company's  simulators  into  the  Place  Table  dialog.  The 
Place  Table  dialog  displays  the  table  of  simulators  for  the  selected  company.  The  function 
call  is  PlaceTableFetch(dialog).  Table  2.14-15  describes  the  parameter  us^  and  functions 
called  using  this  function. 


_ _ Parameters _ 

Parameter  [Type  [Where  Typedet  Declared 

dialog  pointer  to  DialogState  Development:SIMNET;libmac: 

dialog. h  
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1  calls  1 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

CompanyName 

See  Section  2.22.2.9.4. 

SimTableSetup 

See  Section  2.22.2.10.1. 

Table  2.14-15:  PlaceTableFetch  Information. 

2.14.2.4.5  PlaceCompIete 

PlaceComplete  is  called  when  a  valid  Place  Table  dialog  selection  has  been  made  and  the 
dialog  should  be  taken  down.  The  function  call  is  PlaceComplete(sim,  success).  Table 
2.14-16  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

Sim 

pointer  to  SimDescriptor 

DevelopmentiSIMNET  :MCC: 
libsimilibsim.h 

success 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

UpdateScrollTable  Entry 

See  Section  2.22.1.31.1. 

ZoomDownToTableEntry 

See  Section  2.14.2.2.2. 

Table  2.14-16: 


PlaceComplete  Information. 


2.14.2.4.6 


PlaceTableSelect 


PlaceTableSelect  is  called  when  an  entry  in  the  Place  Table  has  been  selected.  The  routine 
checks  the  validity  of  the  selection  and  pops  up  the  dialog  for  placing  the  vehicle.  The 
function  call  is  PlaceTableSelect(defn,  row,  box,  event).  Table  2.14-17  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development:SIMNET  :libmac: 
scroll. h 

row 

int 

Standard  C  type. 

box 

pointer  to  Rect 

DeyelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

eyent 

pointer  to  EventRecord 

DevelopmentTHINK  C; 

Mac  #includes:EventMar.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

entry 

register 

ScrollTableEntryHandle 

Development:SIMNET  ;libmac: 
scroll. h 

Sim 

register  pointer  to 
SimDescriptor 

Development:SIMNET;MCC: 

libsimilibsim.h 
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1  Calls  1 

Function 

Where  Described 

ScrollTable  RowToEnirv 

See  Section  2.22.1.34.1. 

SetScrollTableSelection 

See  Section  2.22.1.37.2. 

SimTableEntrv 

See  Section  2.22.2.10.3. 

ShowCaution 

See  Section  2.22.1.4.1. 

ShowVehicleOialoq 

See  Section  2.22.2.9.5. 

ZoomUpFromTableEntrv 

See  Section  2.14.2.2.1. 

Table  2.14-17:  PlaceTabieSelect  Information. 
2.14.2.4.7  PlaceTableEvent 

PlaceTableEvent  is  called  when  an  entry  in  the  Place  Table  dialog  is  selected.  If  the 
Overview  button  was  pressed,  the  scroU  table  is  discarded  and  the  main  screen  is 
displayed.  The  item  number  of  the  button  is  returned.  The  function  call  is 
PlaceTableEvent(dialog,  itemNo).  Table  2.14-18  describes  the  parameters  used  and 
function  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

itemNo 

int 

resource  id  of  the  button  hit 

Calls 

Function 

Where  Described 

DisposeScrollTable 

See  Section  2.22.1.30.2. 

Table  2.14-18:  PlaceTableEvent  Information. 

2.14.2.4.8  SimuIatorAIIoced 

SimulatorAlloced  notes  that  a  simulator  has  been  allocated  by  the  SCC  console.  If  a  table 
of  simulators  is  being  displayed,  the  screen  is  updated.  The  function  call  is 
SimulatorAlloced(vehicle,  company).  Table  2.14-19  describes  the  parameters  u.sed  and 
function  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

vehicle 

int 

Standard  C  type. 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

sim 

register  pointer  to 
SimDescriptor 

DevelopmentiSIMNET  iMCC; 
libsimilibsim.h 
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1  Calls  1 

Function 

Where  Described 

SimTableUpdate 

See  Section  2.22.2.10.2. 

Called  Bv 

Function 

Where  Described 

ProcessRequest 

See  Section  2.14.2.1.1. 

Table  2.14-19:  SimulatorAlloced  Information. 


2.14.2.4.9  SimulatorPIaced 

SimulatorPlaced  notes  that  a  simulator  has  been  placed  by  another  console.  If  a  table  of 
simulators  is  being  displayed,  the  screen  is  updated.  The  function  call  is 
SimulatorPlaced(sim).  Table  2.14-20  describes  the  parameters  used  and  functions  called 
using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

Sim 

register  pointer  to 
SimDescriptor 

Development:SIMNET  :MCC; 
libsim;libsim.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

placeTable  Dialog. 

extern  DialogNodeDefn 

Development:SIMNET  :libmac: 
sequence. h 

placeTableField 

extern  ScrollTableFieldDefn 

DevelopmentiSIMNET  :libmac: 
scroll.h 

Calls 

Function 

Where  Described 

SimTableUpdate 

See  Section  2.22.2.10.2. 

Called  By 

Function 

Where  Desciibed 

ProcessRequest 

See  Section  2.14.2.1.1. 

Table  2.14-20:  SimulatorPlaced  Information. 

2.14.2.5  setup. c 

Development:SIMNET:MCC:Place:setup.c 

setup.c  initializes  the  Place  application  at  start-up. 

2.14.2.5.1  Setup 

Setup  initializes  the  Place  console  application.  The  toolbox  is  initialized,  the  SEMNET 
Resources  and  Place  Pictures  files  are  opened,  the  Help  Manager  is  initialized,  and  storage 
is  allocated  for  dialog  states.  The  function  call  is  SetUp().  Table  2.14-21  describes  the 
internal  variables  us^  and  functions  called  using  this  function. 
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1  Internal  Variables  I 

Variable 

Type 

Where  Tvpedef  Declared 

errCode 

int 

Standard  C  type. 

port 

GrafPort 

Development:THINK  C: 

Mac  #includes:Quickdraw.h 

finalTicks 

Iona 

Standard  C  type. 

Calls 

Function 

Where  Described 

InitToolbox 

See  Section  2.22.1.20.1. 

Zoom  1  nit 

See  Section  2.22.1.47.1. 

GetCursor 

Standard  Toolbox  Utility  function  for  the  Macintosh. 

OpenResFile 

Standard  Resource  Manaqer  function  for  the  Macintosh. 

MenuBarTitle 

See  Section  2.22.1.43.1. 

Delay 

Standard  Operatina  System  Utility  function  for  the  Macintosh. 

ExitToShell 

Standard  Seqment  Loader  function  for  the  Macintosh. 

DeepShit 

See  Section  2.22.1.8.2. 

helpinit 

See  Section  2.22.1.19.1. 

SystemFailure 

See  Section  2.22.1.8.1. 

NewRr 

Standard  Memory  Manaqer  function  for  the  Macintosh. 

OpenPort 

Standard  Quickdraw  function  for  the  Macintosh. 

SetUpPlace 

See  Section  2.14.2.4.1. 

ClosePort 

Standard  Quickdraw  function  for  the  Macintosh. 

SetUpSimulators 

See  Section  2.22.2.9.1. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.14.2.3.1. 

Table  2.14-21:  SetUp  Information. 


2.14.3  Appearance  of  User  Interface 


2.14.3.1  Place  Pictures 

Development: SIMNET :MCC: Place : Place  Pictures 

Place  Pictures  contains  resources  that  determine  the  appearance  of  the  Place  application's 
user  interface. 
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2.15  The  Admin  Console 


Admin  Console 
1.15 


Truck  Load 
and  Unload 
at  Supply 
Depots 
1.15.1 


-load.c 

1.15.1.1 


Interface 

between 

Admin 

Console 

and 

MCC  Host 
1.15.2 


-atalk.c 

1.15.2.1 
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"1.15.3.1 


Admin 

Console 

Definitions 
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Console 
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I — main.c 

1.15.5.1 

-setup.c 

1.15.5.2 


Appearance 
of  Admin 
User 
Interface 
1.15.6 


I— Admin  Pictures 
1.15.6.1 


— demo.c 

1.15.5.3 
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— models.c 
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Figure  2.15-1:  Admin  Console  Structure. 
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2.15.1  Truck  Load  and  Unload  at  Supply  Depots 


2.15.1.1  load.c 

Development:SIMNET:MCC:Admin:load.c 

load.c  implements  the  user  interface  for  loading  supply  trucks  with  ammunition  and  fuel. 
Table  2.15-1  describes  the  variables  used  by  load.c. 


1  Internal  Variables  I 

Variable 

Type 

Where  Tvpedef  Declared 

toJCkParty 

TransferParty 

Development:SIMNET  :MCC; 
libsuPDlytlibsuDPly.h 

depotParty 

TransferParty 

Development:SIMNET  :MCC: 
libsupply:libsupply.h 

fuelQuantityBuffer 

int 

Standard  C  type. 

fuelLoadCancelField 

PushButtonFieldDefn 

Development:SIMNET  :libmac: 
dialog. h 

fuelLoadQuantityField 

NumberFieldDefn 

DevelopmentrSIMNET  ilibmac: 
dialog. h 

luelTruckLoadFields 

pointer  to  array  ot  FieldDetn 

Development.SIMNETilibmac: 

dialog.h 

fuelT  ruckLoadOialog 

DialogDefn 

DevelopmentrSIMNET  :libmac: 
dialog.h 

Table  2.15-1:  load.c  Variable  Information. 

2.15.1.1.1  ShowLoadDialog 

ShowLoadDialog  pops  up  the  Load  dialog.  The  Load  dialog  is  used  for  loading  a  truck  at  a 
supply  depot.  The  function  call  is  ShowLoadDialog(truck,  window,  rect).  Table  2.15-2 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

truck 

pointer  to  TruckStatus 

Development:SIMNET  :MCC; 
Admin:AdminMac,h 

window 

WindowPtr 

Developmenf.THINK  C: 

Mac  #includes:WindowMgr.h 

rect 

pointer  to  Rect 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

Calls 

Function 

Where  Described 

Show!  ransferAmmoDialog 

See  Section  2.22.3.4.1. 

ShowDialog 

See  Section  2.22.1.11,1. 

ZoomToWindow 

See  Section  2.22.1.47.4. 

Show  Window 

Standard  Window  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

TruckTable  Event 

See  Section  2.15.5.4.4. 

Table  2.15-2:  ShowLoadDialog  Information. 
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2.15.1.1.2  AmmoTruckLoadCompIete 

AmmoTruckLoadComplete  is  called  when  the  OK  button  is  hit  on  the  Ammo  Transfer 
dialog.  This  routine  takes  down  the  Ammo  Transfer  dialog,  zooms  to  the  Truck  Table 
dialog,  and  updates  the  loaded  truck's  row  in  the  Truck  Table.  The  function  call  is 
AmmoTruckLoadComplete ().  Table  2.15-3  describes  the  functions  called  using  this 
function. 


1  Calls  1 

Function 

Where  Described 

HideWindow 

Standard  Window  Manaaer  function  for  Macintosh. 

ZoomToWindow 

See  Section  2.22.1.47.4. 

Update! ruck! able  Row 

See  Section  2.15.5.4.14. 

Table  2.15-3:  AmmoTruckLoadComplete  Information. 
2.15.1.1.3  FuelTruckLoadFetch 

FuelTruckLoadFetch  reads  the  current  values  of  the  fuelQuantityBuffer  data  structure  into 
the  Fuel  Truck  Load  dialog  fields  to  display  to  the  user.  The  function  call  is 
FuelTmckLoadFetch(dialog).  Table  2.15-4  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  :libmac; 
dialog. h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

string 

array  of  20  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SellText 

Standard  Dialoq  Manager  function  for  Macintosh. 

SetText 

See  Section  2.22.1.11.8. 

Table  2.15-4:  FuelTruckLoadFetch  Information. 

2.15.1.1.4  FuelTruckLoadEvent 

FuelTmckLoadEvent  is  called  when  a  button  in  the  Fuel  Truck  Load  dialog  is  pressed. 
When  the  OK  button  is  pressed,  the  routine  checks  the  validity  of  the  data  entered,  updates 
the  fuelQuantityBuffer  of  the  current  truck.  When  the  Cancel  button  is  pressed,  the  Fuel 
Truck  Load  dialog  is  closed.  The  function  call  is  FuelTruckLoadEvent(dialog,  itemNo). 
Table  2.15-5  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 
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Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

Invalid  data  entered. 

Calls 

Function 

Where  Described 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

CloseLoadDialog 

See  Section  2.15.1.1.6. 

Table  2.15-5:  FuelTruckLoadEvent  Information. 

2.15.1.1.5  UpdateLoadDialog 

UpdateLoadDialog  updates  the  load  displayed  in  the  Truck  Load  dialog.  The  function  call 
is  UpdateLoadDidogO.  Table  2.15-6  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

UpdateAmmoT  ransferLoads 

See  Section  2.22.3.4.4. 

Table  2.15-6:  UpdateLoadDialog  Information. 


2.15.1.1.6  CloseLoadDialog 


CIoseLoadDialog  is  called  to  close  the  Truck  Load  dialog.  The  routine  zooms  back  down 
to  the  Truck  Table  dialog  and  updates  the  dispatched  truck’s  row  in  the  truck  table  dialog. 
The  function  call  is  CIoseLoadDialog().  Table  2.15-7  describes  the  functions  called  using 
this  function. 


1  Calls  1 

Function 

Where  Described 

HideWindow 

Standard  Window  Manager  function  for  Macintosh. 

ZoomTo  Window 

See  Section  2.22.1.47.4. 

Throw  Dialog 

See  Section  2.22.1.11.3. 

Update! ruckT able  Row 

See  Section  2.15.5.4.14. 

Called  By 

Function 

Where  Described 

Fuel!  ruckLoadEvent 

See  Section  2.15.1.1.4. 

Table  2.15-7:  CloseLoadDialog  Information. 
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2.15.2  Interface  between  Admin  Console  and  MCC  Host 


2.15.2.1  atalk.c 

Development:SIMNET:MCC:Admin:atalk.c 

atalk.c  processes  requests  and  responses  received  from  the  MCC  host  via  the  AppleTalk 
network.  The  functions  in  this  file  are  only  compiled  if  VERSION  is  APPLETALK. 

2.15.2.1.1  ProcessRequest 

ProcessRequest  processes  a  request  received  from  the  MCC  host.  The  function  call  is 
ProcessRequest(hdl).  Table  2.15-8  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

hdl 

Handle 

DevelopmentTHINK  C: 

Mac  #includes:MacTyoes.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

P 

register  Ptr 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

errCode 

int 

Standard  C  type. 

i 

int 

Standard  C  type. 

truck 

register  pointer  to  TnjckStatus 

Development:SIMNET  ;MCC: 
Admin.AdminMac.h 

1  Calls  1 

Function 

Where  Described 

SetDateTime 

Standard  Operatino  System  Utility  function  for  Macintosh. 

Discard  PopUpDialog 

See  Section  2.15.5.7.9. 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

InitTruckState 

See  Section  2.15.5.7.1. 

Update! ruckTableRow 

See  Section  2.15.5.4,14. 

UpdatePopUpLoad 

See  Section  2.15.5.7.8. 

NotifyStatusChanqe 

See  Section  2.15.5.7.7. 

Restart 

Standard  Operating  System  Utility  function  for  Macintosh. 

ATPResponse 

Standard  Appletalk  Manager  function  for  Macintosh. 

1  Called  By  1 

Function 

Where  Described 

main 

See  Section  2.15.5.1.1. 

Table  2.15-8:  ProcessRequest  Information. 
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2.15.2.1.2  ProcessResponse 

ProcessResponse  processes  a  response  received  from  the  MCC  host.  The  function  call  is 
ProcessResponse(hdl).  Table  2.15-9  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

hdl 

Handle 

DevelopmentiTHINK  C: 

Mac  #includes;MacTvpes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

P 

register  Rr 

Development:THlNK  C: 

Mac  #includes:MacTvpes.h 

truck 

register  pointer  to  TruckStatus 

Development'.SIMNET  ;MCC; 
Admin:AdminMac.h 

1  Calls  1 

Function 

Where  Described 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

See  Section  2.15.5.7.9. 

1  UpdateTruckTableRow 

See  Section  2.15.5.4.14. 

Table  2.15-9:  ProcessResponse  Information. 


2.15.2.1.3  ReportDispatch 


ReportDispatch  reports  to  the  host  that  a  truck,  truck,  has  been  dispatched.  The  function 
call  is  ReportDispatch(truck).  Table  2. 15-10  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

truck 

register  pointer  to  TruckStatus 

Development:SIMNET  :MCC: 
AdminiAdminMac.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

req 

AdminLogDispatchRequest 

DevelopmentiSIMNET  :MCC: 
AdminiAdmin.h 

1  Calls  1 

Function 

Where  Described 

ATPPut 

See  Section  2.22.1.3.3. 

Called  By 

Function 

Where  Described 

TruckDispatchEvent 

See  Section  2.15.3.1.3. 

Table  2.15-10:  ReportDispatch  Information. 
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2.15.2.1.4  ReportHalt 

ReportHalt  reports  to  the  host  that  a  truck,  truck,  has  halted.  The  function  call  is 
ReportHalt(truck).  Table  2.15-1 1  describes  the  parameters  used  and  functions  called  using 
this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

truck 

register  pointer  to  TruckStatus 

Development:SIMNET  :MCC: 
Admin;AdminMac.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

ab 

ABRecHandle 

DevelopmentTHINK  C: 

Mac  #includes;Appletalk.h 

req 

pointer  to 

AdminLooArriveRequest 

Development:SIMNET  :MCC: 
Admin:Admin.h 

rsp 

pointer  to 

AdminLooArriveResponse 

DevelopmentiSIMNET  :MCC: 
Admin:Admin.h 

i 

register  int 

Standard  C  type. 

Calls 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manager  function  for  Macintosh. 

NewPtr 

Standard  Memory  Manager  function  for  Macintosh. 

SetUpATPRequest 

See  Section  2.22.1.3.2. 

ATPRequest 

Standard  Appletalk  Manager  function  lor  Macintosh. 

Called  By 

Function 

Where  Described 

TruckH  alt  Event 

See  Section  2.15.5.5.3. 

Update  TruckLocation 

See  Section  2.15.5.7.3. 

DisableTruck 

See  Section  2.15.5.7.4. 

Table  2.15-11:  ReportHalt  Information. 

2.15.3  Model  Travel  of  Supply  Trucks 

2.15.3.1  dispatch. c 

Development:SIMNET;MCC:Admin:dispatch.c 

dispatch.c  implements  dialogs  for  dispatching  and  halting  supply  trucks.  Table  2.15-12 
describes  the  variables  used  by  dispatch.c. 
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Variables 

Variable 

Where  Tvpedef  Declared 

assignmentBuffer 

char 

Standard  C  type. 

supplyPtBuffer 

char 

Standard  C  type. 

locationBuffer 

MapCoordinates 

Deyeiopment;SIMNET  ;libmac: 
map.h 

dispatchAmmoT able  Field 

Scroll!  ableFieldDef  n 

Development'.SIMNET'.libmac: 

scroll.h 

assignmentFields 

array  of  RBFieldDefn 

DeyelopmentiSIMNET  :libmac: 
dialog. h 

supplyPt  Fields 

array  of  RBFieldDefn 

Development:SiMNET  ;libmac; 
dialog. h 

dispatchCancelField 

PushButtonFieldDefn 

DeyelopmentiSIMNET  ilibmac: 
dialog. h 

locationField 

CoordinatesFieldDefn 

DeyelopmentiSIMNET  ilibmaci 
dialog. h 

ammoT  ruckDispatch  Fields 

pointer  to  array  of  FieldDefn 

DeyelopmentiSIMNET  ilibmaci 
dialog.h 

fuelTruckDispatch  Fields 

pointer  to  array  of  FieldDefn 

DeyelopmentiSIMNET  ilibmaci 
dialog.h 

ammoT  ruckDispatchDialog 

DialogDefn 

DevelopmentiSIMNET  ilibmaci 
dialog.h 

f  uelT ruckDispatch  Dialog 

DialogDefn 

DevelopmentiSIMNET  ilibmaci 
dialog.h 

Table  2.15-12:  dispatch.c  Variable  Information. 


2.15.3.1.1  ShowDispatchDialog 

ShowDispatchDialog  pops  up  the  Dispatch  dialog.  The  Dispatch  dialog  is  used  to  order  a 
truck  to  dispatch.  The  function  call  is  ShowDispatchDialog(truck,  window,  rect).  Table 
2.15-13  describes  the  parameters  used  and  functions  called  using  this  function. 

_ _ Parameters _ _ 

Parameter  Type  Where  Typedef  Declared 

truck  pointer  to  TruckStatus  Development:SIMNET:MCC: 

_ Admin:AdminMac.h _ 

window  WindowPtr  DevelopmentiTHINK  C: 

_ Mac  #includes:WindowMQr.h 

rect  pointer  to  Rect  DevelopmentTHINK  C; 

  Mac  #includes:MacTypes.h 


_ _ Calls _ 

Function  I  Where  Described 

ShowDialog _ See  Section  2.22.1 .1 1.1. _ 

ZoomToWindow _ See  Section  2.22.1 .47.4. _ 

ShowWindow_ Standard  Window  Manager  function  for  Macintosh. 


Called  B 


Function 

Where  Described 

TruckTableEvent 

See  Section  2.15.5.4.5. 

Table  2.15-13:  ShowDispatchDialog  Information. 
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2.15.3.1.2  TruckDispatchFetch 

TruckDispatchFetch  reads  the  current  values  of  the  assignmentBuffer,  supplyPtBuffer, 
locationBuffer,  and  text  fields  into  the  Truck  Dispatch  dialog  fields  to  display  to  the  user. 
The  routine  displays  the  load  onboard  the  current  truck  in  the  dialog.  The  routine  also 
disables  radio  buttons  for  companies  not  belonging  to  the  same  force  as  the  cuirently 
chosen  company.  The  function  call  is  TruckDispatchFetch  (dialog).  Table  2.15-14 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialOQ.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

str 

array  of  100  char 

Standard  C  type. 

forcelD 

char 

Standard  C  type. 

Calls 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

UpdateDispatchLoad 

See  Section  2.15.3.1.5. 

DisableControl 

See  Section  2.22.1.7.1. 

Table  2.15-14;  TruckDispatchFetch  Information. 

2.15.3.1.3  TruckDispatchEvent 

TruckDispatchEvent  is  called  when  a  button  in  the  Truck  Dispatch  dialog  is  pressed.  If  the 
Dispatch  button  is  pressed,  the  location  and  estimated  arrival  time  are  computed,  any 
changes  in  the  company  assignment  radio  buttons  are  noted,  and  the  truck  is  report^  as 
having  been  dispatched.  If  the  Cancel  button  is  pressed,  the  dialog  is  closed.  If  the 
Compute  ETA  button  is  pressed,  the  arrival  time  is  computed  and  displayed.  The  function 
call  is  TruckDispatchEvent(dialog,  itemNo).  Table  2.15-15  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialOQ.h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

str 

array  of  20  char 

Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

ComputeETA 

See  Section  2.15.3.1.4. 

Report  Dispatch 

See  Section  2.15.2.1.3. 

CloseOispatchDialOQ 

See  Section  2.15.3.1.6. 

DTGToStrina 

See  Section  2.22.1.15.1. 

SetText 

See  Section  2.22.1.11.8. 

SellText 

Standard  Dialoa  Manaqer  function  for  Macintosh. 

SetRadioButton 

See  Section  2.22.1.11.6. 

Table  2.15*15:  TruckDispatchEvent  Information. 


2.15.3.1.4  ComputeETA 

ComputeETA  computes  the  currently  displayed  truck’s  arrival  time.  The  routine  ensures 
that  if  the  truck  is  not  being  returned  to  the  supply  point,  a  destination  location  is  entered. 
The  function  call  is  ComputeETA().  Table  2.15-16  describes  the  internal  variables  used 
and  functions  called  using  this  function. 


Internal  Variables 


Variable 


distance 


Return  Value 


Function 


ShowCaution 


PointToMaoCoordinates 


DistBetweeen2Pts 


GetDateTime 


DTGEIaosed 


Function 


TruckDisoatchEvent 


Where  Tvoedef  Declared 


Standard  C  type. 


Return  Values 


Type 


int 


int 


Meanin 


Unable  to  compute  ETA. 


Successful. 


Calls 


Where  Described 


See  Section  2.22.1.4.1. 


See  Section  2.22.1.26.2. 


See  Section  2.22.1.23.2. 


Standard  OperatinqSystem  Utility  function  for  Macintosh. 


See  Section  2.22.1.15.3. 


n 


Called  B 


Where  Described 


See  Section  2.15.3.1.3. 


Table  2.15-16:  ComputeETA  Information. 

2.15.3.1.5  UpdateDispatchLoad 

UpdateDispatchLoad  updates  the  load  displayed  in  the  Truck  Dispatch  dialog.  The  function 
call  is  UpdateDispatchLoadC).  Table  2. 15-17  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


Internal  Variables 


Variable 


Where  Tvoedef  Declared 


Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

EmptvScrollTable 

See  Section  2.22.1.28.2. 

FillAmmunitionList 

See  Section  2.22.1.5.1. 

SetText 

See  Section  2.22.1.11.8. 

Called  By 

Function 

Where  Described 

TruckDispatchFetch 

See  Section  2.15.3.1.2. 

Table  2.15-17:  UpdateDispatchLoad  Information. 

2.15.3.1.6  CloseDispatchDialog 

CloseDispatchDialog  is  called  to  close  a  Truck  Dispatch  dialog.  The  function  call  is 
CloseDispatchDialogO.  Table  2.15-18  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

DisposeScrollTable 

See  Section  2.22.1.30.2. 

HideWindow 

Standard  Window  Manager  function  for  Macintosh. 

ZoomTo  Window 

See  Section  2.22.1.47.4. 

ThrowDialoa 

See  Section  2.22.1.11.3. 

Update! ruck! able  Row 

See  Section  2.15.5.4.14. 

Called  By 

Function 

Where  Described 

TruckDispatchEvent 

See  Section  2.15.3.1.3. 

Table  2.15-18:  CloseDispatchDialog  Information. 


2.15.4  Admin  Console  Definitions 


2.15.4.1  Admin. h 

Development:SIMNET :  MCC:  Admin :  Admin.h 

Admin.h  defines  the  representation  of  information  communicated  between  the  Admin 
Macintosh  application  and  the  MCC  host. 

2.15.4.2  AdminMac.h 

Development:SIMNET:MCC:Admin:AdminMac.h 

AdminMac.h  defines  types,  constants  and  routines  used  within  the  Admin  Macintosh 
application.  Table  2.15-19  describes  the  variables  used  by  AdminMac.h. 
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1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

ammoTrucks 

extern  array  of  TruckStatus 

Development:SIMNET  :MCC: 
Admin;AdminMac.h 

fuelTrucks 

extern  array  of  TruckStatus 

DeveiopmentiSiMNET  :MCC: 
Admin:AdminMac.h 

ammoSupply  Point 

extern  MapCoordinates 

Development:SIMNET  ilibmac: 
map.h 

ammoLupplyContent 

extern  Manifest 

Development;SIMN  ET :MCC: 
inciudeiresuppiy.h 

fuelSupplyPoint 

extern  MapCoordinates 

DeveiopmentiSIMNET  :libmac; 
map.h 

currentTruck 

extern  pointer  to  TruckStatus 

Development:SIMNET  ;MCC; 
AdminrAdminMac.h 

zoomBase  Window 

extern  WindowPtr 

DeveiopmentTHINK  C; 

Mac  #includes:WindowMqr.h 

zoomBaseRect 

extern  Rect 

DeveiopmentTHINK  C: 

Mac  #inciudes;MacTvDes.h 

popUpDiaiogState 

pointer  to  DiaiogState 

Deveiopment:SiMNET  :libmac: 
diaioq.h 

(updatePopUpDiaioq)O 

extern  void  function  caii 

Standard 

(ciosePopUpDiaioq){) 

extern  void  function  caii 

Standard 

battieScheme 

extern  char 

Standard  C  type. 

bnForceiD 

extern  char 

Standard  C  type. 

company  Force  iD 

extern  array  of 
maxNumberCompanies  char 

Standard  C  type. 

startUpCompiete 

extern  char 

Standard  C  type. 

Table  2.15-19:  AdminMac.h  Variablelnformation. 


2.15.5  Admin  Console  Software 


2.15.5.1  main.c 

Development:SIMNET:MCC:Admin:main.c 

main.c  contains  the  Admin  application’s  program  entry  point  and  main  event  loop. 

2.15.5.1.1  main 

main  is  the  application  entry  point.  The  function  call  is  main().  Table  2.15-20  describes 
the  functions  called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

Setup 

See  Section  2.15.5.2.1. 

ProcessRequest 

See  Section  2.15.2.1.1. 

SetUpAppleTalk 

See  Section  2.22.1.3.1. 

DownloadlerrainMap 

See  Section  2.22.1.3.4. 

DownloadInitialData 

See  Section  2.15.5.1.2. 

LoadCannedData 

See  Section  2.15.5.1.1. 

MenuBarlitle 

See  Section  2.22.1.43.1. 

InstallClock 

See  Section  2.22.1.6.4. 

ShowTruckTables 

See  Section  2.15.5.4.2. 

MainEventLoop 

See  Section  2.15.5.1.3. 

Table  2.15*20:  main  Information. 

2.15.5.1.2  DownloadInitialData 

DownloadInitialData  downloads  information  about  the  depots  and  trucks.  It  is  only 
compiled  if  VERSION  is  APPLETALK.  The  function  call  is  DownloadInitialData().  Table 
2.15-21  describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

my  Event 

EventRecord 

DevelopmentrTHINK  C: 

Mac  #includes;EventMar.h 

Calls 


Function 

Where  Described 

GetNextEvent 

Standard  Toolbox  Event  Manaqer  function  for  Macintosh. 

NetworkEventHandler 

See  Section  2.22.1.3.5. 

Called  Bv 

Function 

Where  Described 

main 

See  Section  2.15.5.1.1. 

Table  2.15-21:  DownloadInitialData  Information. 


2.15.5.1.3  MainEventLoop 

MainEventLoop  processes  incoming  events  from  the  queue.  The  function  call  is 
MainEventLoopO.  Table  2.15-22  describes  the  internal  variables  used  and  functions  called 
using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

event 

EventRecord 

DevelopmentTHINK  C: 

Mac  #lticludes:EventMqr.h 

truck 

register  pointer  to  TruckStatus 

Development:SlMNET  :MCC: 
AdminiAdminMac.h 

str 

array  of  char 

Standard  C  type. 

1  1 

405 


BBN  Systems  and  Technologies 


MCC  CSCI 


1  Cans 1 

Function 

Where  Described 

UpdateClock 

See  Section  2.22.1.6.2. 

CheckTimers 

See  Section  2.15.5.7.2. 

SystemTask 

Standard  Desk  Manager  function  for  Macintosh. 

GetNext  Event 

Standard  Toolbox  Event  Manager  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

ATPCIoseSocket 

Standard  Appletalk  Manager  function  for  Macintosh. 

ExitToShell 

Standard  Segment  Loader  function  for  Macintosh. 

ShowVersions 

See  Section  2.22.1.44.1. 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

WindowEvent 

See  Section  2.22.1.46.2. 

NetworkEventHandler 

See  Section  2.22.1.3.5. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.15.5.1.1. 

Table  2.15-22:  MainEventLoop  Information. 


2.15.5.2  setup. c 

E)evelopment:SIMNET;MCC;Adniin;setup.c 
setup.c  initializes  the  Admin  application  at  start-up. 

2.15.5.2.1  Setup 

SetUp  initializes  the  AdminA-og  application.  The  Macintosh  application  environmnet  is 
initialized,  the  SIMNET  Resources  and  Admin  Pictures  files  are  opened,  the  random 
number  generator  is  initialized,  the  tables  of  truck  information  are  initialized,  and  the 
dialogs  are  initialized.  The  function  call  is  SetUpQ.  Table  2. 15-23  describes  the  internal 
variables  used  and  functions  called  using  this  function. 


Variable 


port 


finalTicks 


Internal  Variables 


e 


GrafPort 


reoister  short 


register  pointer  to  TruckStatus 


Where  Tvbedef  Declared 


Development:THINK  C: 
Mac  #jncludes;Quickdraw.h 


Standard  C  type. 


Standard  C  type. 


De  velopme  nt:SIMNET:MCC: 
Admin:AdminMac.h 
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1  Calls  1 

Function 

Where  Described 

InitToolbox 

See  Section  2.22.1.20.1. 

Zoomlnit 

See  Section  2.22.1.47.1. 

OpenResFile 

Standard  Resource  Manaoer  function'  for  Macintosh. 

MenuBarTitle 

See  Section  2.22.1.43.1. 

Delay 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

ExitToShell 

Standard  Seqment  Loader  function  for  Macintosh. 

DeepShit 

See  Section  2.22.1.8.2. 

GetDateTime 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

InitTruckState 

See  Section  2.15.5.7.1. 

NewRr 

Standard  Memory  Manaqer  function  for  Macintosh. 

OpenPort 

Standard  Quickdraw  function  for  Macintosh. 

SetUpTruckTables 

See  Section  2.15.5.4.1. 

ClosePort 

Standard  Quickdraw  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.15.5.1.1. 

Table  2.15-23:  SetUp  Information. 


2.15.5.3  demo.c 

Development:SIMNET:MCC:Admin;demo.c 


demo.c  loads  canned  data  into  application  data  structures,  in  the  standalone  demo  version 
of  the  Admin  application. 

2.15.5.3.1  LoadCannedData 


LoadCannedData  loads  precanned  demo  data.  The  function  call  is  LoadCannedData(). 
Table  2.15-24  describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

i 

reqister  short 

Standard  C  type. 

truck 

register  pointer  to  TruckStatus 

Development:SIMNET  :MCC: 
AdminiAdminMac.h 

1  Calls  1 

Function 

Where  Described 

StrinqToMapCoordinates 

See  Section  2.22.1.26.1. 

1  Called  By  1 

Function 

Where  Described 

main 

See  Section  2.15.5.1.1. 

Table  2.15-24:  LoadCannedData  Information. 
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2.15.5.4  table.c 

Development:  SIMNETrMCC:  Admin :  table.c 

table.c  implements  dialogs  displaying  tables  of  ammo  and  fuel  supply  trucks.  Table 
2.15-25  describes  the  variables  used  by  table.c. 


1  Variables  I 

Variable 

Type 

Where  Tvpedef  Declared 

ammoT ruck! able  Dialog  Def  n 

extern  DialogDefn 

Development:SIMNET  :libmac: 
dialoq.h 

f  ue  ITruckT able  Dialog  Def  n 

extern  DialogDefn 

Development:SIMNET  :libmac: 
dialoq.h 

ammoTmckData 

TmckTableData 

Development:SIMNET  :MCC: 
Admin  :table.c 

fuelTruckData 

TmckTableData 

Development:SIMNET  :MCC: 
Admin  itable.c 

ammoT  ruckT  ableColumns 

array  of  FixTableColumnDefn 

Development:SIMNET  :libmac; 
table. h 

ammoT aickT able  Field 

FixTableFieldDefn 

Development:SIMNET  :libmac: 
table. h 

byAmmoType 

char 

Standard  C  type. 

ammoT  ruckLoadFields 

array  of  RBFieldDefn 

DevelopmentiSIMNET  rlibmac: 
dialoq.h 

ammoTruckTableFieldList 

pointer  to  array  of  FieldDefn 

Development:SIMNET  rlibmac: 
dialoq.h 

ammoT  ruckT  able  DialogDef  n 

DialogDefn 

DevelopmentrSIMNET  rlibmac: 
dialoq.h 

ammoT  ruckT able  DialogState 

pointer  to  DialogState 

DevelopmentrSIMNET  rlibmac: 
dialoq.h 

fuelTruckTableColumns 

array  of  FixTableColumnDefn 

DevelopmentrSIMNET  rlibmac: 
table. h 

fuelTruckTableField 

FixTableFieldDefn 

DevelopmentrSIMNET  rlibmac: 
table. h 

fuelT  ruckT  ableFieldUst 

pointer  to  array  of  FieldDefn 

DevelopmentrSIMNET  rlibmac: 
dialoq.h 

fuelT  ruckTableDialogDefn 

DialogDefn 

DevelopmentrSIMNET  rlibmac: 
dialoq.h 

fuelTruckTableDialogState 

pointer  to  DialogState 

DevelopmentrSIMNET  rlibmac: 
dialoq.h 

Table  2.15-25:  table.c  Variable  Information. 


2.15.5.4.1  SetUpTruckTables 

SetUpTruckTables  initializes  the  Ammo  Truck  and  the  Fuel  Truck  dialogs.  The  function 
call  is  SetUpTruckTablesQ.  Table  2.15-26  describes  the  functions  called  using  this 
function. 


1  Calls  1 

Function 

Where  Described 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

Text  Size 

Standard  Quickdraw  function  for  Macintosh. 

StrinqWidth 

Standard  Quickdraw  function  for  Macintosh 

ShowDialoq 

See  Section  2.22.1.11.1. 

408 


BBN  Systems  and  Technologies 


MCC  CSCI 


Called  Bv 

Function 

Where  Described 

Setup 

See  Section  2.15.5.4.1. 

Table  2.15-26:  SetUpTruckTables  Information. 

2.15.5.4.2  ShowTruckTables 

ShowTruckTables  makes  the  Ammo  Truck  and  Fuel  Truck  dialogs  visible.  The  function 
call  is  ShowTruckTablesQ.  Table  2.15-27  describes  the  functions  called  using  this 
function. 


1  Calls  1 

Function 

Where  Described 

ShowWindow 

Standard  Window  Manaqer  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

main 

See  Section  2.15.5.1.1. 

Table  2.15-27:  ShowTruckTables  Information. 

2.15.5.4.3  TruckTableFetch 

TruckTableFetch  initializes  a  truck  table  dialog,  dialog,  and  updates  the  Dispatch  and  Load 
buttons.  The  function  call  is  TruckTableFetch(dialog).  Table  2.15-28  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

Calls 

Function 

Where  Described 

UpdateButtons 

See  Section  2.15.5.4.15. 

Table  2.15-28:  TruckTableFetch  Information. 

2.15.5.4.4  TruckTableEvent 

TruckTableEvent  handles  an  event  in  a  truck  table  dialog.  The  item  number  of  the  event  is 
returned.  The  function  call  is  TruckTableEvent(dialog,  itemNo).  Table  2.15-29  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

1  1 
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1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

table 

pointer  to  FixTableFieldDefn 

OevelopmentiSIMNET  ilibmac; 
table.h 

data 

pointer  to  TruckTableData 

Development:SIMNET  :MCC: 
Adminitable.c 

truck 

pointer  to  TruckStatus 

Development:SIMNET  :MCC: 
Admin:AdminMac.h 

theltem 

Handle 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

i 

int 

Standard  C  type. 

rect 

Rect 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

savePort 

GrafRr 

Deyelopment:THINK  C: 

Mac  #includes;Quickdraw.h 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

itemNo 

int 

the  resource  id  of  the  button 
pressed. 

1  Calls  1 

Function 

Where  Described 

Select  Window 

Standard  Window  Manaqer  function  lor  Macintosh. 

FixTableRowRect 

See  Section  2.22.1.42.5. 

ShowHaltDialoq 

See  Section  2.15.5.5.1. 

ShowDisoatchDialoq 

See  Section  2.15.3.1.1. 

See  Section  2.15.1.1.1. 

GetDItem 

Standard  Dialoq  Manaqer  function  for  Macintosh. 

GetPori 

Standard  Quickdraw  function  for  Macintosh. 

Set  Port 

Standard  Quickdraw  function  for  Macintosh. 

InvalRect 

Standard  Dialoq  Manaqer  function  for  Macintosh. 

Table  2.15-29:  TruckTableEvent  Information. 


2.15.5.4.5  TruckTableSelect 

TruckTableSelect  handles  a  mouse  click  in  a  table  of  trucks.  The  function  call  is 
TruckTableSelect(defn,  row,  box).  Table  2.15-30  describes  the  parameters  used  and 
functions  called  using  this  function. 


410 


BBN  Systems  and  Technologies 


MCC  CSCI 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

buf 

register  pointer  to 
TruckTableData 

Development;SIMNET  :MCC: 
Adminitable.c 

save  Port 


GrafRr 


Development:THINK  C: 
Mac  #jncludes;MacTvDes.h 


Development:THINK  C; 
Mac  #includes;Quickdraw.h 


Function 


Get  Port 


SetPort 


FixTableRowRect 


InvertRect 


UpdateButtons 


Calls 


Where  Described 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


See  Section  2.22.1.42.5. 


Standard  Quickdraw  function  for  Macintosh. 


See  Section  2.15.5.4.15. 


Table  2.15-30:  TruckTableSelect  Information. 


2.15.5.4.6  TruckDrawNumber 

TruckDrawNumber  fills  in  the  Truck  Number  column  for  the  specified  truck  in  the  Truck 
Table.  The  function  call  is  TruckDrawNumber(defn,  col,  row).  Table  2.15-31  describes 
the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

DevelopmentiSIMNET  :libmac: 
table. h 

col 

pointer  to 

FixT  ableColumnDefn 

Development:SIMNET  :libmac: 
table. h 

row 

int 

Standard  C  type. 

Variable 


truck 


Internal  Variables 


e  Where  Typedef  Declared 


register  pointer  to  TruckStatus  DevelopmentiSIMNET ;MCC: 

AdminiAdminMac.h 


array  of  1 0  char  Standard  C  type. 


Calls 


Function  Where  Described 


NumToString  Standard  Binary  to  Decimal  Conversion  Package  function  for 

Macintosh. 


Move  Standard  Quickdraw  function  for  Macintosh. 


CharWidth  Standard  Quickdraw  function  for  Macintosh. 


Drawstring  Standard  Quickdraw  function  for  Macintosh. 


Table  2.15-31:  TruckDrawNumber  Information. 
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2.15.5.4.7  TruckDrawAssignment 


TruckDrawAssignment  fills  in  the  Company  Assignment  column  for  the  specified  truck  in 
the  Truck  Table.  The  function  call  is  TruckDrawAssignment(defn,  col,  row).  Table 
2.15-32  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

Development:SIMNET  :libmac: 
table. h 

col 

pointer  to 

FixT  ableColumnDefn 

Development:SIMNET  :libmac; 
table. h 

row 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

truck 

register  pointer  to  TruckStatus 

Development:SIMNET  :MCC; 
Admin:AdminMac.h 

Pt 

Point 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

forcelD 

char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetPen 

Standard  Quickdraw  function  for  Macintosh. 

MoveTo 

Standard  Quickdraw  function  for  Macintosh. 

Strinq  Width 

Standard  Quickdraw  function  for  Macintosh. 

Standard  Quickdraw  function  for  Macintosh. 

1  DrawChar  | 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.15-32:  TruckDrawAssignment  Information. 


2.15.5.4.8  TruckDrawAmmoLoad 


TruckDrawAmmoLxjad  fills  in  the  Ammo  Load  column  for  the  specified  truck  in  the  Truck 
Table.  The  function  call  is  TruckDrawAmmoLoad(table,  column,  row).  Table  2.15-33 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

table 

pointer  to  FixTableFieldDefn 

Development:SIMNET  ;libmac; 
table. h 

column 

pointer  to 

FixT  ableColumnDefn 

Development:SIMNET  :libmac: 
table. h 

row 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

truck 

pointer  to  TruckStatus 

Development:SIMNET  :MCC: 
AdminAdminMac.h 

rect 

Rect 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes  h 
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1  Calls  1 

Function 

Where  Described 

FixTableRowRect 

See  Section  2.22.1.42.5. 

DisplayAmmoLoadSummary 

See  Section  2.22.3.7.1. 

Table  2.15-33:  TruckDrawAmmoLoad  Information. 


2.15.5.4.9  TruckDrawFuelLoad 


TruckDrawFuelLx)ad  fills  in  the  Fuel  Load  column  for  the  specified  truck  in  the  Truck 
Table.  The  function  call  is  TruckDrawFuelLoad(defn,  col,  row).  Table  2.15-34  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

DevelopmentiSIMNET  :libmac: 
table. h 

col 

pointer  to 

FixT  ableColumnDef  n 

DevelopmentiSIMNET  tlibmac; 
table. h 

row 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

truck 

register  pointer  to  TruckStatus 

Developmenl:SIMNET  :MCC; 
Admin:AdminMac.h 

str 

array  of  1 0  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 

Move 

Standard  Quickdraw  function  for  Macintosh. 

Strinq  Width 

Standard  Quickdraw  function  for  Macintosh. 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.15-34:  TruckDrawFuelLoad  Information. 


2.15.5.4.10  TruckDrawStatus 


TruckDrawStatus  fills  in  the  Status  column  for  the  specified  truck  in  the  Truck  Table.  The 
function  call  is  TruckDrawStatus(defn,  col,  row).  Table  2.15-35  describes  the  parameters 
used  and  functions  called  using  this  function. 


_ _ Parameters _ 

Parameter  [Type  I  Where  Typedef  Declared 

defn  pointer  to  FixTableFieldDefn  Development:SIMNET:libmac: 

_ table. h _ 

col  pointer  to  Development:SIMNET:libmac: 

_ FixTableColumnPefn _ table. h _ 

row  int  Standard  C  type. 
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1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

truck 

register  pointer  to  TruckStatus 

DevelopmenttSIMNET  ;MCC; 
Admin  :AdminMac.h 

statusStrinq 

pointer  to  array  of  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.15-35:  TruckDrawStatus  Information. 

2.15.5.4.11  TruckDrawLocation 

TruckDrawLocation  fills  in  the  Location  column  for  the  specified  truck  in  the  Truck  Table. 
The  function  call  is  TruckDrawLocation(defn,  col,  row).  Table  2.15-36  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

Development;SIMNET  ilibmac: 
table. h 

col 

pointer  to 

FixT  ableColumnDef  n 

DevelopmentiSIMNET  :libmac: 
table. h 

row 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

truck 

register  pointer  to  TruckStatus 

Development:SIMNET  :MCC: 
AdminiAdminMac.h 

str 

pointer  to  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

DrawText 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.15-36:  TruckDrawLocation  Information. 

2.15.5.4.12  TruckDrawETA 

TruckDrawETA  fills  in  the  Estimated  Time  of  Arrival  column  for  the  specified  truck  in  the 
Truck  Table.  The  function  call  is  TruckDrawETA(defn,  col,  row).  Table  2.15-37 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

Development:SIMNET  :libmac: 
table. h 

col 

pointer  to 

FixT  ableColumnDef  n 

Development:SIMNET  ilibmac: 
table. h 

row 

int 

Standard  C  type. 

1  1 
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1  Internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

truck 

register  pointer  to  TruckStatus 

Development:SIMNET  :MCC: 
Admin  lAdminMac.h 

str 

array  of  20  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

DTGToStrina 

See  Section  2.22.1.15.1. 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.15-37:  TruckDrawETA  Information. 


2.15.5.4.13  TruckTableHilite 

TruckTableHilite  inverts  the  text  of  the  specified  row  if  it  is  selected.  If  the  truck  for  that 
row  is  disabled  or  destroyed,  the  row  is  pickled.  The  function  call  is 
TruckTableHilite(defn,  row,  box).  Table  2.15-38  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

Development:SIMNET  :libmac; 
table. h 

row 

int 

Standard  C  type. 

box 

pointer  to  Red 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

truck 

register  pointer  to  TruckStatus 

Development:SIMNET  :MCC; 
Admin:AdminMac.h 

pattern 

pointer  to  Pattern 

DevelopmentTHINK  C: 

Mac  #includes;Quickdraw.h 

destroyedPattern 

Pattern 

Development.THINK  C: 

Mac  #includes;Quickdraw.h 

disabledPattern 

Pattern 

DevelopmentiTHINK  C: 

Mac  #includes:Quickdraw.h 

Calls 

Function 

Where  Described 

PenMode 

Standard  Quickdraw  function  for  Macintosh. 

PenPat 

Standard  Quickdraw  function  for  Macintosh. 

PaintRect 

Standard  Quickdraw  function  for  Macintosh. 

InvertRect 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.15-38:  TruckTableHilite  Information. 
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2.15.5.4.14  UpdateTruckTableRow 

UpdateTruckTableRow  updates  the  row  displaying  a  particular  truck,  truck.  If  the  updated 
row  is  the  selected  one,  the  buttons  are  also  updat^.  The  function  call  is 
UpdateTruckTableRow(truck).  Table  2.15-39  describes  the  parameters  used  and  functions 
csdled  using  this  function. 


Parameter 


truck 


Parameters 


e  Where  Tvpedef  Declared 


register  pointer  to  TruckStatus  Development;SIMNET :MCC: 

Admin:AdminMac.h 


Variable 


dialog 


internal  Variables 


e 


pointer  to  DialogState 


1 073 


Where  Tvoedef  Declared 


Development;SIMNET  ilibmac: 
dialog. h 


Function 


UodateFixTableRow 


UpdateButtons 


Calls 


Where  Described 


See  Section  2.22.1.42.2. 


See  Section  2.15.5.4.15. 


Function 


AmmoT  ruckLoadComplete 


CloseLoadDialo 


ProcessReouest 


ProcessResponse 


CloseDispatchDialo 


CloseHaltDialo 


Update!  ruckLocation 


DisableTruck 


EnableTruck 


Called  B 


Where  Described 


See  Section  2.15.1.1.2. 


See  Section  2.15.1.1.6. 


See  Section  2.15.2.1.1. 


See  Section  2.15.2.1.2 


See  Section  2.15.3.1.6. 


See  Section  2.15.5.5.6. 


See  Section  2.15.5.7.3. 


See  Section  2.15.5.7.4. 


See  Section  2.15.5.7.5. 


Table  2,15-39:  UpdateTruckTableRow  Information. 

2.15.5.4.15  UpdateButtons 

UpdateButtons  labels  and  enables  push  buttons  according  to  the  status  of  tlie  currently 
selected  truck.  The  Load  button  is  enabled  if  a  truck  at  the  supply  depot  has  been  selected. 
The  Dispatch/Halt  button  is  labeled  according  to  the  truck  selected.  The  Dispatch/Halt 
button  is  enabled  if  an  ojierable  truck  is  selected.  The  function  call  is 
UpdateButtons(dialog).  Table  2. 1 5-40  describes  the  parameters  used  and  functions  called 
using  this  function. 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

truck 

register  pointer  to  TruckStatus 

Development:SIMNET  :MCC: 
Admin  :AdminMac.h 

i 

int 

Standard  C  type. 

theltem 

Handle 

Dev^lopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

box 

Rect 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

Calls 

Function 

Where  Described 

EnableControl 

See  Section  2.22.1.7.2. 

DisableControl 

See  Section  2.22.1.7.1. 

GetDltem 

Standard  Dialog  Manager  function  for  Macintosh. 

SetCTitle 

Standard  Control  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

TruckTableFetch 

See  Section  2.15.5.4.3. 

TruckTableSelect 

See  Section  2.15.5.4.5. 

UpdateTruckTableRow 

See  Section  2.15.5.4.14. 

Table  2.15-40:  UpdateButtons  Information. 

2.15.5.4.16  SelectTruckTableRow 

SelectTruckTableRow  returns  the  currently  selected,  visible  truck  table  row.  The  function 
call  is  SelectTruckTableRow().  Table  2.15-41  describes  the  internal  variables  used  by  this 
function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

data 

pointer  to  Truck! able  Data 

Development;SIMNET  :MCC: 
Adminlable.c 

Return  Values 

Return  Value 

Type 

Meaning 

0 

pointer  to  TruckStatus 

Unsuccessful. 

&data->trucks[ 

data->selection1 

pointer  to  TruckStatus 

Status  data  of  the  selected 
truck  row. 

Table  2.15-41:  SelectTruckTableRow  Information. 
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2.15.5.5  halt.c 

Development:SIMNET  :MCC:  Admin:halt.c 


halt.c  implements  dialogs  for  halting  supply  trucks.  Table  2.15-42  describes  the  variables 
used  by  halt.c. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

haltAmmoT  ableField 

ScrollTableFieldDefn 

Development:SIMNET  :libmac: 
scroll.h 

ammoT  ruckHaltFields 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

fuelTruckHaltFields 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  rlibmac; 
dialog. h 

ammoT  ruckHaltDialog 

DialogDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

fuelT  ruckHaltDialog 

DialogDefn 

DevelopmentiSIMNETilibmac: 
dialog. h 

Table  2.15-42:  halt.c  Variable  Information. 
2.15.5.5.1  ShowHaltDialog 


ShowHaltDialog  pops  up  a  dialog  for  ordering  a  truck,  truck,  to  stop  travelling.  The 
function  call  is  ShowHaltDialog(truck,  window,  rect).  Table  2.15-43  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  1 

Parameter 

Type 

Where  Typedef  Declared 

truck 

pointer  to  TruckStatus 

DevelopmentiSIMNET  iMCC: 
AdminiAdminMac.h 

window 

WindowPtr 

DevelopmentiTHINK  C: 

Mac  fincludesiWindowMqr.h 

rect 

pointer  to  Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTvpes.h 

Calls 

Function 

Where  Described 

ShowDialog 

See  Section  2.22.1.11.1, 

ZoomTo  Window 

See  Section  2.22.1.47.4. 

Show  Window 

Standard  Window  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

TruckTableEvent 

See  Section  2.15.5.4.4. 

Table  2.15-43:  ShowHaltDialog  Information. 
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2.15.5.5.2  TruckHaltFetch 

TruckHaltFetch  loads  the  text  fields  into  the  Truck  Halt  dialog  and  displays  the  load 
onboard  the  truck.  The  function  call  is  TruckHaltFetch(dialog).  Table  2.15-44  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  ;libmac; 
dialog. h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

str 

array  of  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

UpdateHallLocation 

•See  Section  2.15.5.5.4. 

SetText 

See  Section  2.22.1.11.8. 

DTGToStrinq 

See  Section  2.22.1.15.1. 

UpdateHaltLoad 

See  Section  2.15.5.5.5. 

Table  2.15-44:  TruckHaltFetch  Information. 

2.15.5.5.3  TruckHaltEvent 

TruckHaltEvent  is  called  to  report  the  truck’s  travel  as  having  been  halted  when  the  Halt 
button  is  pressed,  and  to  close  the  Truck  Halt  dialog  when  the  Cancel  button  is  pressed. 
The  function  call  is  TruckHaltEvent(dialog,  itemNo).  Table  2.15-45  describes  ^e 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

ReporiHalt 

See  Section  2.15.2.1.4. 

CloseHalt  Dialog 

See  Section  2.15.5.5.6. 

Table  2.15-45; 


TruckHaltEvent  Information. 
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2.15.5.5.4  Updat.eHaltLocation 

UpdateHaltLocation  updates  the  location  of  the  truck,  truck,  shown  in  the  Truck  Halt 
dialog.  The  function  call  is  UpdateHaltLocation(truck).  Table  2.15-46  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

truck 

register  pointer  to  TruckStatus 

Development:SIMNET  :MCC: 
Admin:AdminMac.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

str 

array  of  100  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

Called  By 

Function 

Where  Described 

TruckHaltFetch 

See  Section  2.15.5.5.2. 

UpdateTruckLocation 

See  Section  2.15.5.7.3. 

Table  2.15-46:  UpdateHaltLocation  Information. 

2.15.5.5.5  UpdateHaitLoad 

UpdateHaltLoad  updates  the  load  displayed  in  the  Truck  Halt  dialog.  The  function  call  is 
UpdateHaltLoad().  Table  2.15-47  describes  the  internal  variables  used  and  functions  called 
using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

str 

array  ot  50  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

EmptyScrollTable 

See  Section  2.22.1.28.2. 

FiilAmmunitionList 

See  Section  2.22.3.5.1. 

SetText 

See  Section  2.22.1.11.8. 

Called  By 

Function 

Where  Described 

TruckHaltFetch 

See  Section  2.15.5.5.2. 

Table  2.15-47:  UpdateHaltLoad  Information. 
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2.15.5.5.6  CloseHaltDialog 

CloseHaltDialog  is  called  to  close  the  Truck  Halt  dialog.  The  routine  discards  any  scrolling 
list  of  ammo  quantities,  zooms  back  down  to  the  Truck  Table  dialog,  and  updates  the  halted 
truck's  row  in  the  Truck  Table  dialog.  The  function  call  is  CloseHaltDialog().  Table  2.15- 
48  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

DisposeScrollTable 

See  Section  2.22.1.30.2. 

HideWindow 

Standard  Window  Manaqer  function  for  Macintosh. 

ZoomToWindow 

See  Section  2.22.1.47.4. 

ThrowDialoq 

See  Section  2.22.1.11.3. 

Update!  njckl  ableRow 

See  Section  2.15.5.4.14. 

Called  By 

Function 

Where  Described 

TmckHaltEvent 

See  Section  2.15.5.5.3. 

Table  2.15-48:  CloseHaltDialog  Information. 

2.15.5.6  data.c 

Development:SIMNET  :MCC:Admin:data.c 

data.c  contains  data  definitions  for  the  Admin/Log  application.  Table  2.15-49  describes  the 
variables  used  by  data.c. 
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1  Variables  I 

Variable 

Type 

application 

pointer  to  char 

Standard  C  type. 

authors 

pointer  to  char 

Standard  C  type. 

LliJ 

pointer  to  char 

Standard  C  type. 

ammoTrucks 

array  of 

numberBnM977Vehicles 

TruckStatus 

Development:SIMNET  :MCC: 
Admin:AdminMac.h 

fuelTrucks 

array  of 

numberBnM978Vehicles 

TruckStatus 

Development;SIMNET  :MCC: 
Admin;AdminMac.h 

ammoSupplyPoint 

MapCoordinates 

DevelopmentrSIMNET  :libmac: 
map.h 

ammoSupplyContent 

Manifest 

Development:SIMNET  :MCC: 
includeiresupply.h 

fuelSupplyPoint 

MapCoordinates 

Development:SIMNET  :libmac: 
map.h 

currenlTruck 

pointer  to  TruckStatus 

Development  :SIMNET  :MCC; 
Admin:AdminMac.h 

zoomBase  Window 

WindowPtr 

DevelopmentTHINK  C; 

Mac  #includes:WindowMQr.h 

zoomBaseRect 

Rect 

DevelopmentTHINIK  C: 

Mac  #includes;MacTypes.h 

popUpDialogState 

pointer  to  DialogState 

Development:SIMNET  ;libmac: 
dialoq.h 

void  function  call 

Standard 

(closePopUpDialoQlO 

void  function  call 

Standard 

battleScheme 

char 

Standard  C  type. 

bn  Force  ID 

char 

Standard  C  type. 

companyForcelD 

array  of 

maxNumberCompanies  char 

Standard  C  type. 

startupComplete 

char 

Standard  C  type. 

Table  2.15-49:  data.c  Variable  Information. 


2.15.5.7  models. c 

Development;SIMNET:MCC:Admin:model.c 

models.c  contains  functions  which  model  time-based  processes  involving  supply  trucks, 
such  as  breakdowns. 

2.15.5.7.1  InitTruckState 

InitTruckState  initializes  the  state  of  a  truck,  truck.  The  function  call  is 
InitTruckState(truck).  Table  2.15-50  describes  the  parameters  used  and  functions  called 
using  this  function. 
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1  Calls  1 

Function 

Where  Described 

Random 

Standard  Quickdraw  function  for  Macintosh. 

DisableTruck 

See  Section  2.15.5.7.4. 

ScheduleDisableEvent 

See  Section  2.15.5.7.6. 

Called  By 

Function 

Where  Described 

ProcessRequest 

See  Section  2.15.2.1.1. 

Setup 

See  Section  2.15.5.2.1. 

Table  2.15-50:  InitTruckState  Information. 


2.15.5.7.2  CheckTimers 

CheckTimers  looks  for  a  time-driven  change  in  status.  The  routine  performs  rime-based 
processing  once  per  minute,  and  checks  for  ammo  and  fuel  trucks  having  moved,  arrived, 
become  broken  or  fixed.  The  function  call  is  CheckTimers().  Table  2.15-51  describes  the 
internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

now 

Standard  C  type. 

i 

register  short 

Standard  C  type. 

truck 

register  pointer  to  TruckStatus 

DevelopmentiSIMNET  ;MCC: 
AdmintAdminMac.h 

nextUpdateTime 

unsigned  long 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

EnableTruck 

See  Section  2.15.5.7.5. 

Update!  ruckLocation 

See  Section  2.15.5.7.3. 

DisableTruck 

See  Section  2.15.5.7.4. 

1  Called  By  1 

Function 

Where  Described 

MainEventLoop 

See  Section  2.15.5.1.3. 

Table  2.15-51:  CheckTimers  Information. 


2.15.5.7.3  UpdateTruckLocation 

UpdateTruckLocation  updates  the  status  of  a  displacing  truck.  If  the  truck  has  arrived  at  its 
destination,  any  pop-up  halt  dialogs  are  discarded.  If  the  truck's  destination  is  its  supply 
depot,  the  host  and  user  are  notified  that  the  truck  is  ready  for  loading.  If  the  truck  has  not 
yet  arrived  at  its  destination,  the  routine  periodically  updates  an  interpolation  of  its  current 
location.  The  function  call  is  UpdateTruckLocation(now,  truck).  Table  2.15-52  describes 
the  parameters  used  and  functions  called  using  this  function. 
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Parameter 


now 


truck 


Function 


DscardPoDUoDialo 


UodateT ruck! able  Row 


ReoortHalt 


NotifvStatusChanae 


InteroolatePoints 


PointToMaoCoordinates 


UpdateHaltLocation 


Parameters 


unsianed  Ion 


register  pointer  to  TruckStatus 


MCC  CSCl 


Where  Tvoedef  Declared 


Standard  C  type. 


DevelopmentrSIMNET  :MCC: 
AdminiAdminMac.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

pt 

pointer  to  LongR 

Development:SIMNET  :libmac: 
lonqpt.h 

Standard  C  type. 


Calls 


Where  Described 


See  Section  2.15.5.7.9. 


See  Section  2.15.5.4.14. 


See  Section  2.15.2.1.4. 


See  Section  2.15.5.7.7. 


See  Section  2.22.1.23.4. 


See  Section  2.22.1.26.2. 


See  Section  2.15.5.5.4. 


Called  B 


Function 

Where  Described 

CheckTimers 

See  Section  2.15.5.7.2. 

Table  2.15*52:  UpdateTruckLocation  Information. 
2.15.5.7.4  DisableTruck 

DisableTruck  marks  a  truck,  truck,  as  temporarily  disabled.  The  routine  first  ensures  that 
no  more  than  20%  of  the  trucks  in  a  fleet  are  disabled.  Then,  this  truck  is  marked  as 
disabled.  Any  current  dialog  pertaining  to  this  truck  is  taken  down.  If  the  truck  was 
travelling,  the  host  and  user  are  notified  that  it  has  stopped.  The  repair  of  the  vehicle  is 
scheduled.  The  function  call  is  DisableTruck(truck).  Table  2.15-53  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


truck 


Parameters 


e  Where  Typedef  Declared 


register  pointer  to  TruckStatus  Development.SIMNET :MCC; 

Admin.AdminMac.h 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

fleetSize 

int 

Standard  C  type. 

numberDisabled 

int 

Standard  C  type. 

reqister  short 


register  pointer  to  TruckStatus 


Standard  C  type. 


Deyelopment:SIMNET  :MCC: 
Admin:AdminMac.h 
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1  Calls  1 

Function 

Where  Described 

DiscardPopUpDialoq 

See  Section  2.22.6.5.9. 

ReportHalt 

See  Section  2.15.2.1.4. 

NotifyStatusChanqe 

See  Section  2.15.5.7.7. 

Update! ruck! able  Row 

See  Section  2.15.5.4.14. 

ScheduleDisableEvent 

See  Section  2.15.5.7.6. 

Called  By 

Function 

Where  Described 

InitTruckState 

See  Section  2.15.5.7.1. 

CheckTimers 

See  Section  2.15.5.7.2. 

Table  2.15-53:  DisableTruck  Information. 


2.15.5.7.5  EnableTruck 


EnableTruck  reenables  a  truck,  truck,  when  it  has  been  repaired.  The  user  is  notified  that 
the  truck  is  no  longer  disabled.  The  function  call  is  EnableTruck(truck).  Table  2.15-54 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

truck 

pointer  to  TruckStatus 

Development:SIMNET  :MCC: 
AdminiAdminMac.h 

Calls 

Function 

Where  Described 

NotifyStatusChanqe 

See  Section  2.15.5.7.7. 

UpdateTruckTableRow 

See  Section  2.15.5.4.14. 

SchPduleDisableEve.  .t 

See  Section  2.15.5.7.6. 

Called  By 

Function 

Where  Described 

CheckTimers 

See  Section  2.15.5.7.2. 

Table  2.15-54:  EnableTruck  Information. 


2.15.5.7,6  ScheduleDisableEvent 

ScheduleDisableEvent  determines  the  amount  of  time  before  a  truck  next  becomes  broken 
or  fixed.  The  function  call  is  ScheduleDisableEvent(tiuck,  diceRange,  numberDie).  Table 
2.15-55  describes  the  parameters  used  and  functions  called  using  this  function. 
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Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

dice 

register  short 

Standard  C  type. 

register  short 


Standard  C  type. 


Calls 

Function 

Where  Described 

Random 

Standard  Quickdraw  function  for  Macintosh. 

Function 


InitTruckState 


DisableTruck 


EnableTruck 


Called  B 


Where  Described 


See  Section  2.15.5.7.1. 


See  Section  2.15.5.7.4. 


See  Section  2.15.5.7.5. 


Table  2.15*55:  ScheduIeDisableEvent  Information. 
2.15.5.7.7  NotifyStatusChange 

NotifyStatusChange  notifies  the  user  of  a  change  in  the  state  of  a  truck,  truck,  state  is  the 
curent  state  of  the  truck.  The  function  call  is  NotifyStatusChange(truck,  state).  Table 
2.15-56  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


truck 


Variable 


Function 


CountCaution 


LastCaution 


ShowCaution 


Parameters 


register  pointer  to  TruckStatus 


Where  Tvpedef  Declared 


Development.SIMNET  :MCC: 
Admin-.AdminMac.h 


Standard  C  type. 


Internal  Variables 


e 


ointerto  char 


array  of  100  char 


Where  Tvoedef  Declared 


Standard  C  type. 


Standard  C  type. 


Calls 


Where  Described 


See  Section  2.22.1.4.4. 


Standard  Dialoa  Manaoer  function  for  Macintosh. 


See  Section  2.22.1.4.3. 


See  Section  2.22.1.4.1. 


Called  B 


Function 

Where  Described 

ProcessReguest 

See  Section  2.15.2.1.1. 

Update!  ruckLocation 

See  Section  2.15.5.7.3. 

DisableTruck 

See  Section  2.15.5.7.4. 

EnableTruck 

See  Section  2.15.5.7.5. 

Table  2.15-56:  NotifyStatusChange  Information. 
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2.15.5.7.8  UpdatePopUpLoad 

UpdatePopUpLoad  updates  the  load  displayed  in  any  pop-up  dialog  for  the  specified  truck, 
truck.  The  function  call  is  UpdatePopUpLoad(truck).  Table  2.15-57  describes  the 
parameters  used  by  this  function. 


\  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

truck 

register  pointer  to  TruckStatus 

Development:SIMNET  :MCC: 
Admin:AdminMac.h 

Called  By 

Function 

Where  Described 

ProcessRequest 

See  Section  2.15.2.1.1. 

Table  2.15-57:  UpdatePopUpLoad  Information. 
2.15.5.7.9  DiscardPopUpDialog 

DiscardPopUpDialog  discards  any  pop-up  dialog  for  dispatching,  halting  or  loading  the 
specified  truck,  truck.  The  function  call  is  DiscardPopUpDialog(truck).  Table  2.15-58 
describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

truck 

register  pointer  to  TruckStatus 

Development:SIMNET  ;MCC: 
Admin;AdminMac.h 

Called  By 

Function 

Where  Described 

ProcessRequest 

See  Section  2.15.2.1.1. 

ProcessResponse 

See  Section  2.15.2.1.2. 

Update!  ruckLocation 

See  Section  2.15.5.7.3. 

Table  2.15-58:  DiscardPopUpDialog  Information. 


2.15.6  Appearance  of  Admin  User  Interface 


2.15.6.1  Admin  Pictures 

Development:SIMNET:MCC:Admin:Admin  Pictures 

Admin  Pictures  contains  resources  that  determine  the  appearance  of  the  Admin  application's 
user  interface. 
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2.16  The  Maint  (Maintenance)  Console 


Interface 

between 

Maint 

Console 

and 

MCC  Host 

1.16.1 


recover.c 

’1.16.2.1 


.^talk.c 

1.16.1.1 


Maint.  h 

1.16.3.1 

MaintMac.h 

1.16.3.2 


main.c 

"1.16.4.1 

setup.c 

"1.16.4.2 

resource,  h 
"1.16.4.3 

demo.c 

"1.16.4.4 


■Maint  Pictures 
1.16.5.1 


.4eamtable.c 

1.16.4.5 

dispatch.c 

"1.16.4.6 

-start.c 

1.16.4.7 

-repairtable.c 

1.16.4.8 

-cancel.c 

1.16.4.9 

-halt.c 

1.16.4.10 

-model.c 

1.16.4.11 

-data.c 

1.16.4.12 


Figure  2.16-1:  Maint  (Maintenance)  Console  Structure. 
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2.16.1  Interface  between  Maint  Console  and  MCC  Host 


2.16.1.1  atalk.c 

Development:  SIMNET  :MCC:Maint:atalk.c 


atalk.c  processes  requests  and  responses  received  from  the  MCC  host  via  the  AppleTalk 
network.  This  file  is  only  compiled  if  VERSION  is  APPLETALK. 

2.16.1.1.1  ProcessRequest 

ProcessRequest  processes  a  request  received  from  the  MCC  host.  This  function  is  only 
compiled  if  \TRSION  is  APPLETALK.  The  function  call  is  ProcessRequest(hdl).  Table 
2.16-1  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

hdl 

Handle 

Devetopment:THINK  C: 

Mac  #includes:MacTypes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

P 

register  Rr 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

errCode 

int 

Standard  C  type. 

i 

int 

Standard  C  type. 

team 

register  pointer  to  TeamStatus 

Development  :SIMNET  ;MCC: 
Maint  :MaintMac.h 

repairSetP 

pointer  to  pointer  to  RepairSet 

Development:SIMNET  ;MCC: 
Maint  :MaintMac.h 

str 

array  of  100  char 

Standard  C  type. 

nameFormats 

pointer  to  array  of  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

Discard  PopUpDialoq 

See  Section  2.16.4.11.9. 

CancelRepair 

See  Section  2.16.4.9.5. 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

InitTeamState 

See  Section  2.16.4.11.1. 

UpdateTeamTableRow 

See  Section  2.16.4.5.12. 

ShowCaution 

See  Section  2.22.1.4.1. 

NotifyStateChanqe 

See  Section  2.16.4.11.8. 

ATPResponse 

Standard  Appletalk  Manaqer  function  for  Macintosh. 

Restart 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

SetDateTime 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

1  Called  Bv  1 

Function 

Where  Described 

main 

See  Section  2.16.4.1.1. 

Table  2.16-1:  ProcessRequest  Information. 
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2.16.1.1.2  ProcessResponse 


ProcessResponse  processes  a  response  received  from  the  MCC  host.  This  functior.  is  only 
compiled  if  VERSION  is  APPLETALK.  The  function  call  is  ProcessResponse(hdl). 

Table  2.16-2  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

hdl 

Handle 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

P 

registerRr 

DevelopmentTHINK  C: 

Mac  #includes;MacTvpes.h 

team 

register  pointer  to  TeamStatus 

DevelopmentiSIMNET  :MCC: 
Maint;MaintMac.h 

1  Calls  1 

Function 

Where  Described 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

Discard  PopUpDialoq 

See  Section  2.16.4.11.9. 

UpdafeTeamTableRow 

See  Section  2.16.4.5.12. 

Table  2.16-2:  ProcessResponse  Information. 

2.16.1.1.3  ReportDispatch 

ReportDispatch  repons  to  the  host  that  a  team,  team,  has  been  dispatched.  This  function  is 
only  compiled  if  VERSION  is  APPLETALK.  The  function  call  is  ReportDispatch(team). 
Table  2.16-3  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

team 

register  pointer  to  TeamStatus 

DevelopmentiSIMNET  ;MCC: 
Maint;MaintMac.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

req 

MaintDispatchRequest 

DevelopmentiSIMNET  iMCC; 
MaintiMaint.h 

Calls 

Function 

Where  Described 

ATPPut 

See  Section  2.22.1.3.3. 

Called  By 

Function 

Where  Described 

TeamDispatchEvent 

See  Section  2.16.4.6.3. 

CheckTimers 

See  Section  2.16.4.11.2. 

Table  2.16-3:  ReportDispatch  Information. 
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2.16.1.1.4  ReportHalt 

ReportHalt  reports  to  the  host  that  a  team,  team,  has  halted.  This  function  is  only  compiled 
if  VERSION  is  APPLETALK.  The  function  call  is  ReportHalt(team).  Table  2.16-4 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

team 

register  pointer  to  TeamStatus 

Development  ;SIMNET  ;MCC: 
Maint;MaintMac.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

ab 

ABRecHandle 

DevelopmentiTHINK  C: 

Mac  #includes  Appletalk. h 

req 

pointer  to  MaintArriveRequest 

DevelopmentiSIMNET  ;MCC; 
MaintiMaint.h 

rsp 

pointer  to 

MaintArriveResponse 

DevelopmentiSIMNET  :MCC: 
MaintiMaint.h 

i 

reqister  int 

Standard  C  type. 

Calls 

Function 

Where  Described 

SetUpATPRequest 

See  Section  2.22.1.3.2. 

ATPRequest 

Standard  Appletalk  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

TeamHaltEvent 

See  Section  2.16.4.10.3. 

Update!  eamLocation 

See  Section  2.16.4.11.3. 

DisableTeam 

See  Section  2.16.4.11.5. 

Table  2.16-4:  ReportHalt  Information. 

2.16.1.1.5  ReportRepair 

ReportRepair  reports  to  the  host  that  a  repair,  repair,  has  been  completed  by  team.  The 
function  call  is  ReportRepair(team,  repair).  Table  2.16-5  describes  the  parameters  used 
and  functions  call^  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

team 

register  pointer  to  TeamStatus 

Development:SIMNET  :MCC: 
MaintiMaintMac.h 

repair 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

req 

Mai  nt  Repai  rRequest 

Development:SIMNET  :MCC; 
Maint;Maint.h 

1  1 
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1  Calls  1 

Function 

Where  Described 

ATPPut 

See  Section  2.22.1.3.3. 

Called  6v 

Function 

Where  Described 

RepairCompleted 

See  Section  2.16.4.11.4. 

Table  2.16-5:  ReportRepair  Information. 

2.16.2  Model  Travel  of  Maint  Teams 

2.16.2.1  recover.c 

Development:SIMNET:MCC:Maint:recover.c 

recover.c  implements  a  dialog  for  initiating  towing  of  a  vehicle  by  a  maintenance  team. 
Table  2.16-6  describes  the  variables  used  by  recover.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

depotBuffer 

char 

Standard  C  type. 

locationBuffer 

MapCoordinates 

Development:SIMNET  ilibmac: 
map.h 

depotFields 

array  of  RBFiekJDefn 

Development:SIMNET  :libmac; 
dialoQ.h 

recoverCancelField 

PushButtonFieldDefn 

DevelopmentiSIMNET  :libmac. 
dialog. h 

locationField 

CoordinatesFieldDefn 

DevelopmentiSIMNET  rlibmac: 
dialog. h 

teamRecoverFields 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

teamRecoverDialog 

Dialog  Defn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

Table  2.16-6:  recover.c  Variable  Information. 

2.16.2.1.1  ShowRecoverDialog 

ShowRecoverDialog  pops  up  a  dialog  for  ordering  a  team  to  recover.  The  function  call  is 
ShowRecoverDialog(team,  window,  rect).  Table  2.16-7  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

team 

pointer  to  TeamStatus 

DevelopmentiSIMNET  iMCCi 
MaintiMaintMac.h 

window 

WindowPtr 

DevelopmentiTHINK  Ci 

Mac  #includesiWindowMor.h 

rect 

pointer  to  Rect 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTYpes  h 

1  1 
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1  Calls  1 

Function 

Where  Described 

ShowDialoq 

See  Section  2.22.1.11.1. 

ZoomTo  Window 

See  Section  2.22.1.47.4. 

ShowWindow 

Standard  Window  Manaqer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

TeamTabieEvent 

See  Section  2.16.4.5.4. 

Table  2.16-7:  ShowRecoverDialog  Information. 

2.16.2.1.2  RecoverFetch 

RecoverFetch  reads  the  current  values  of  the  team  recover  data  structures  into  the  Recover 
dialog  for  display  to  the  user.  The  function  call  is  RecoverFetch(dialog).  Table  2.16-8 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

str 

array  of  50  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

Table  2.16-8:  RecoverFetch  Information. 

2.16.2.1.3  RecoverEvent 

RecoverEvent  handles  an  event  in  the  Recover  dialog.  If  the  Recover  button  was  pressed, 
the  destination  and  arrival  times  are  calculated.  If  the  Cancel  button  is  pressed,  the  dialog  is 
closed.  If  the  ComputeETA  button  is  pressed,  the  arrival  time  is  calculated  and  displayed. 
The  function  call  is  RecoverEvent(dialog,  itemNo).  Table  2.16-9  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development;SIMNET  :libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

str 

array  of  20  char 

Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

ComputeETA 

See  Section  2.16.2.1.4. 

CloseRecoverDialoa 

See  Section  2.16.2.1.5. 

DTGTo.*iitrina 

See  Section  2.22.1.15.1. 

SetText 

See  Section  2.22.1.11.8. 

SellText 

Standard  Dialoq  Manager  function  for  Macintosh. 

SetRadioButton 

See  Section  2.22.1.11.6. 

Table  2.16-9:  RecoverEvent  Information. 


2.16.2.1.4  ComputeETA 

ComputeETA  computes  the  cunendy  displayed  team’s  arrival  time.  The  function  call  is 
ComputeETA().  Table  2.16-10  describes  the  internal  variables  used  and  functions  called 
using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

distance 

lonq 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

0 

int 

No  destination  entered. 

1 

int 

Successful. 

Calls 

Function 

Where  Described 

ShowCaution 

See  Section  2.22.1.4.1. 

PointToMapCoordinates 

See  Section  2.22.1.26,2. 

DistBetween2Pts 

See  Section  2.22.1.23.2. 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

DTGEIapsed 

See  Section  2.22.1.15.3. 

Called  By 

Function 

Where  Described 

RecoverEvent 

See  Section  2.16.2.1.3. 

Table  2.16-10:  ComputeETA  Information. 


2.16.2.1.5  CloseRecoverDialog 

CloseRecoverDialog  is  called  to  close  the  team  recover  dialog,  dialog.  The  function  call  is 
CloseRecoverDialog(dialog).  Table  2.16-1 1  describes  the  parameters  used  and  functions 
called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

Hide  Window 

Standard  Window  Manaoer  function  for  Macintosh. 

ZoomTo  Window 

See  Section  2.22.1.47.4. 

ThrowDialoa 

See  Section  2.22.1.11.3. 

UpdateTeamTableRow 

See  Section  2.16.4.5.12. 

Called  Bv 

Function 

Where  Described 

RecoverEvent 

See  Section  2.16.2.1.3. 

Table  2.16-11:  CloseRecoverDialog  Information. 


2.16.3  Maint  Console  Definitions 


2.16.3.1  Maint. h 

Development:SIMNET;MCC:Maint;Maint.h 

Maint.h  defines  the  representation  of  information  communicated  between  the  Maint 
Macintosh  application  and  the  MCC  host. 

2.16.3.2  MaintMac.h 

Development:SIMNET:MCC:Maint:MaintMac.h 

MaintMac.h  defines  types,  constants  and  routines  used  within  the  Maint  Macintosh 
application.  Table  2.16-12  describes  the  variables  used  by  MaintMac.h. 
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1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

repairCiassName 

extern  pointer  to  array  of  char 

Standard  C  type. 

armor  r  amCapabilities 

extern  TeamCapabilities 

Development;SIMNET  :MCC: 
Maint  ;MaintMac.h 

repairTableField 

extern  ScrollTableFieldDefn 

DevelopmentiSIMNET  liibmac: 
scroll. h 

mainlTeams 

extern  array  of  TeamStatus 

Development;SIMNET  :MCC; 
MaintiMaintMac.h 

select  edTeam 

extern  short 

Standard  C  type. 

currentTeam 

extern  pointer  to  TeamStatus 

Development:SIMNET  :MCC; 
Maint.MaintMac.h 

currentRepair 

extern  RepairHandle 

Development  :SIMNET  :MCC: 
Maint;MaintMac.h 

zoomBase  Window 

extern  WindowRr 

DevelopmentiTHINK  C: 

Mac  #includes:WindowMar.h 

zoomBaseRect 

extern  Rect 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

popUpDialogState 

extern  pointer  to  DialogState 

Development:SIMNET  ilibmac: 
dialoa.h 

(close  PopUpDialooK) 

extern  void  function  call 

Standard 

battleScheme 

extern  char 

Standard  C  type. 

bn  Force  ID 

extern  char 

Standard  C  type. 

companyForcelD 

extern  array  of 

maxNumberCompanies  char 

Standard  C  type. 

startupComplete 

extern  char 

Standard  C  type. 

repairDepot 

extern  MapCoordinates 

Development;SIMNET  :libmac: 
map.h 

Table  2.16-12:  MaintMac.h  Variable  Information. 


2.16.4  Maint  Console  Software 


2.16.4.1  main.c 

E)evelopment:SIMNET:MCC:Maint:main.c 

main.c  contains  the  Maint  application's  program  entry  point  and  main  event  loop. 

2.16.4.1.1  main 

main  is  the  application  entry  point.  The  function  call  is  main().  Table  2.16-13  describes 
the  functions  called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

Setup 

See  Section  2.16.4.2.1. 

ProcessRequest 

See  Section  2.16.1.1.1. 

SetUpAppleTalk 

See  Section  2.22.1.3.1. 

Download!  e  rrai  nM  ap 

See  Section  2.22.1.3.4. 

DownloadInitialData 

See  Section  2.16.4.1.2. 

LoadCannedData 

See  Section  2.16.4.4.1. 

MenuBarTitle 

See  Section  2.22.1.43.1. 

InstallClock 

See  Section  2.22.1.6.4. 

ShowTeamTable 

See  Section  2.16.4.5  2. 

MainEventLoop 

See  Section  2.16.4.1.3. 

Table  2.16-13:  main  Information. 


2.16.4.1  2  DownloadInitialData 

DownloadInitialData  downloads  information  about  the  maintenance  teams  and  repairs 
depots.  This  function  is  only  compiled  if  VERSION  is  APPLETALK.  The  function  call  is 
DownloadInitialDataO.  Table  2.16-14  describes  the  internal  variables  used  and  functions 
called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

my  Event 

EventRecord 

DevelopmentTHINK  C: 

Mac  #includes:EventMqr.h 

Calls 

Function 

Where  Described 

GetNextEvent 

Standard  Toolbox  Event  Manager  tunction  lor  Macintosh. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.16  4.1.1. 

Table  2.16-14:  DownloadInitialData  Information. 


2.16.4.1.3  MainEventLoop 

MainEventLoop  sits  in  a  loop  forever  fielding  incoming  events.  The  function  call  is 
MainEventLoopO.  Table  2.16-15  describes  the  internal  variables  used  and  functions  called 
using  this  function. 


Internal  Variables 


Variable 

Type 

Where  Typedet  Declared 

event 

EventRecord 

DevelopmentTHINK  C: 

Mac  #includes:EventMqr.h 

team 

register  pointer  to  TeamStatus 

Development:SIMNET  ;MCC; 
Maint:MaintMac.h 

repair 

RepairHandle 

Development:SIMNET  :MCC: 
Maint:MaintMac.h 

str 

array  of  100  char 

Standard  C  type. 
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Calls 

Function 

Where  Described 

UpdateClock 

See  Section  2.22.1.6.2. 

CheckTimers 

See  Section  2.16.4.11.2. 

SystemTask 

Standard  Desk  Manager  function  for  Macintosh. 

GetNextEvent 

Standard  Toolbox  Event  Manager  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

Update!  earn!  ableRovy 

See  Section  2.16.4.5.12. 

ATPCIoseSocket 

Standard  Appletalk  Manager  function  for  Macintosh. 

ExitToShell 

Standard  Segment  Loader  function  for  Macintosh. 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

ShowVersions 

See  Section  2.22.1.44.1. 

WindowEvent 

See  Section  2.22.1.46.2. 

NetworkEventHandler 

See  Section  2.22.1.3.5. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.16.4.1.1. 

Table  2.16-15:  MainEventLoop  Information. 


2.16.4.2  setup. c 

Development:SIMNET  :MCC:Maint:setup.c 

setup.c  initializes  the  Maint  application  at  start-up. 

2.16.4.2.1  Setup 

SetUp  initializes  the  Maint  application.  The  SIMNET  Resources  and  Maint  Pictures  files 
are  opened.  The  random  number  generator  is  initialized,  the  table  of  team  information  is 
initialized,  and  the  dialogs  are  initialized.  The  function  call  is  SetUp().  Table  2.16-16 
describes  the  internal  variables  used  and  functions  called  using  this  function. 


Variable 


port 


finalTicks 


Internal  Variables 


e 


GrafPort 


reaister  short 


register  pointer  to  TeamStatus 


Where  Tvoedef  Declared 


DevelopmentTHINK  C: 
Mac  #includes:Quickdraw.h 


Standard  C  tvoe. 


Standard  C  type. 


DevelopmentiSIMNET  :MCC: 
Maint  iMaintMac.h 
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1  Calls  1 

Function 

Where  Described 

InitToolbox 

See  Section  2.22.1.20.1. 

Zoomlnit 

See  Section  2.22.1.47.1. 

OpenResFile 

Standard  Resource  Manaaer  function  for  Macintosh. 

MenuBarTitle 

See  Section  2.22.1.43.1. 

Delay 

Standard  Operatino  System  Utility  function  for  Macintosh. 

ExitToShell 

Standard  Seqment  Loader  function  for  Macintosh. 

DeepShit 

See  Section  2.22.1.8.2. 

GetDateTime 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

InitTeamState 

See  Section  2.16.4.11.1. 

NewRr 

Standard  Menrwry  Manaqer  function  for  Macintosh. 

OpenPort 

Standard  Quickdraw  function  for  Macintosh. 

SetUpRepairTable 

See  Section  2.16.4.8.1. 

SetUpTeamTable 

See  Section  2.16.4.5.1. 

ClosePort 

Standard  Quickdraw  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

main 

See  Section  2.16.4.1.1. 

Table  2. 16*16:  SetUp  Information. 

2.16.4.3  resource.h 

Development:SIMNET:MCC:Maint:resource.h 

resource.h  defines  the  resource  numbers  of  the  Maint  Pictures  resources. 

2.16.4.4  demo.c 

Development:SIMNET:MCC:Maint;demo.c 

demo.c  contains  a  function  which  loads  precanned  values  for  the  demo  version  of  the  Maint 
console  application. 

2.16.4.4.1  LoadCannedData 


LoadCannedData  loads  precanned  demo  data.  The  function  call  is  LoadCannedData(). 
Table  2.16-17  describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

i 

reqister  short 

Standard  C  type. 

team 

pointer  to  TeamStatus 

Development;SIMNET;MCC: 
Maint  iMaintMac.h 

Calls 

Function 

Where  Described 

StrinqToMapCoordinates 

See  Section  2.22.1.26.1. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.16.4.1.1. 

Table  2.16-17:  LoadCannedData  Information. 
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2.16.4.5  teamtable.c 

Develooment:SIMNET:MCC:Maint:teamtable.c 


teamtable.c  implements  a  dialog  displaying  a  table  of  maintenance  teams.  Table  2.16-18 
describes  the  variables  used  by  teamtable.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

team!  ableColumns 

array  of  FixTableColumnDefn 

DevelopmentiSIMNET  :libmac; 
table. h 

teamTableField 

FixTableFieldDefn 

DevelopmentiSIMNET  ilibmac: 
table. h 

teamTableFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialOQ.h 

teamJableDialogDefn 

DialogDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

teamTableOialogState 

pointer  to  DialogState 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

Table  2.16-18:  teamtable.c  Variable  Information. 


2.16.4.5.1  SetUpTeamTable 

SetUpTeamTable  initializes  a  truck  table  dialog.  The  function  call  is  SetUpTeamTable(). 
Table  2.16-19  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

TextFont 

Standard  Quickdraw/  function  for  Macintosh. 

TextSize 

Standard  Quickdraw  function  for  Macintosh. 

String  Width 

Standard  Quickdraw  function  for  Macintosh. 

NewRr 

Standard  Memorv  Manager  function  for  Macintosh. 

ShowDialog 

See  Section  2.22.1.11.1. 

Called  By 

Function 

Where  Described 

Setup 

See  Section  2.16.4.2.1. 

Table  2.16-19:  SetUpTeamTable  Information. 


2.16.4.5.2  ShowTeamTable 


ShowTeamTable  makes  the  maintenance  team  table  dialog  visible.  The  function  call  is 
ShowTeamTableO.  Table  2.16-20  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

ShowWindow 

Standard  Window  Manager  function  for  Macintosh. 

Select  Window 

Standard  Window  Manager  function  for  Macintosh. 

1  1 
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1  Called  Bv  1 

Function 

Where  Described 

main 

See  Section  2.16.4.1.1. 

ShowTeamTable 

See  Section  2.16.4.8.4. 

Table  2.16-20:  ShowTeamTable  Information. 
2.16.4.5.3  TeamTableFetch 

TeamTableFetch  initializes  the  maintenance  team  table  dialog  and  updates  the  action 
buttons.  The  function  call  is  TeamTableFetch(dialog).  Table  2.16-21  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Tvoe 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  ilibmac; 
dialog. h 

Calls 

Function 

Where  Described 

UpdateTeamTableButtons 

See  Section  2.16.4.5.13. 

Table  2.16-21:  TeamTableFetch  Information. 

2.16.4.5.4  TeamTableEvent 

TeamTableEvent  handles  an  event  in  the  maintenance  team  table  dialog.  If  the  Repairs 
button  is  pressed,  the  Repair  Table  is  displayed.  If  the  Dispatch  button  is  pressed,  the 
appropriate  Dispatch  or  Halt  dialog  is  displayed.  If  the  Recover  button  is  pressed,  the  tow 
dialog  is  displayed.  If  the  StartRepair  button  is  pressed,  the  repair  selection  is  displayed. 
The  function  call  is  TeamTableEveni(dialog,  itemNo).  Table  2. 16-22  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

team 

pointer  to  TeamStatus 

Development:SIMNET  :MCC: 
MaintiMaintMac.h 

theltem 

Handle 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

i 

int 

Standard  C  type. 

rect 

Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

Return  Values 

Return  Value 

Type 

Meaning 

itemNo 

int 
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Calls 

Function 

Where  Described 

ShowReoairTable 

See  Section  2.16.4.8.2. 

FixTableRowRect 

See  Section  2.22.1.42.5. 

ShowDispatchDialoa 

See  Section  2.16.4.6.1. 

ShowHalt  Dialog 

See  Section  2.16.4.10.1. 

ShowRecoverDialoq 

See  Section  2.16.2.1.1. 

ShowStartDialoq 

See  Section  2.16.4.7.1. 

Table  2.16-22:  TeamTableEvent  Information. 

2.16.4.5.5  TeamTableSelect 

TeamTableSelect  handles  a  mouse  click  in  the  table  of  maintenance  teams.  The  function 
call  is  TeamTableSelect(defn,  row,  box).  Table  2.16-23  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

Devetopment:SIMNET  ilibmac; 
table. h 

row 

int 

Standard  C  type. 

box 

pointer  to  Rect 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

r 

Rect 

DevelopmentTHINK  C; 

Mac  #includes;MacTypes.h 

savePort 

GrafRr 

DeyelopmentiTHINK  C; 

Mac  #includes:Quickdraw.h 

Calls 

Function 

Where  Described 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh, 

FixTableRowRect 

See  Section  2.22.1.42.5. 

InvertRect 

Standard  Quickdraw  function  for  Macintosh. 

UpdateTeamTabieButtons 

See  Section  2.16.4.5.13. 

Table  2.16-23:  TeamTableSelect  Information. 
2.16.4.5.6  TeamDrawNumber 


TeamDrawNumber  fills  in  the  Team  Number  field  of  the  specified  column  in  the  Team 
Table.  The  function  call  is  TeamDrawNumber(defn,  col,  row).  Table  2.16-24  describes 
the  parameters  used  and  functions  called  using  this  function. 
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Parameters 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

Development:SIMNET  :libmac: 
table. h 

col 

pointer  to 

FixT  ableColumnDef  n 

DevelopmentrSIMNET  ;libmac; 
table  .h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

team 

register  pointer  to  TeamStatus 

Development:SIMNET  ;MCC: 
MaintiMaintMac.h 

array  of  10  char 


Standard  C  t 


Function 


NumToString 


Move 


CharWidth 


DrawStrin 


Calls 


Where  Described 


Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Table  2.16-24:  TeamDrawNumber  Information. 

2.16.4.5.7  TeamDrawAssignment 

TeamDrawAssignment  fills  in  the  Team  Assignment  field  of  the  specified  column  in  the 
Team  Table.  The  function  call  is  TeamDrawAssignment(defn,  col,  row).  Table  2.16-25 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

Development:SIMNET  ;libmac: 
table. h 

col 

pointer  to 

FixT  ableColumnDef  n 

Development:SIMNET  ilibmac: 
table. h 

row 

int 

Standard  C  type. 

Variable 


team 


Pt 


forcelD 


Internal  Variables 


e 


\WPE 


Where  Typedef  Declared 


register  pointer  to  TeamStatus  Development:SIMNET :MCC: 

MaintiMaintMac.h 


DevelopmentTHINK  C: 
Mac  #includes:MacTvDes.h 


Standard  C  tvoe. 
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1  Calls  1 

Function 

Where  Described 

GetPen 

Standard  Quickdraw  function  for  Macintosh. 

MoveTo 

Standard  Quickdraw  function  for  Macintosh. 

Strinq  Width 

Standard  Quickdraw  function  for  Macintosh. 

Drawstring 

Standard  Quickdraw  function  for  Macintosh. 

DrawChar 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.16-25:  TeamDrawAssignment  Information. 
2.16.4.5.8  TeamDrawStatus 

TeamDrawStatus  fills  in  the  Team  Status  field  of  the  specified  column  in  the  Team  Table. 
The  function  call  is  TeamDrawStatus(defn,  col,  row).  Table  2.16-26  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

Devetopment:SIMNET  :libmac: 
table. h 

col 

pointer  to 

FixTableColumnDefn 

Development:SIMNET  :libmac: 
table. h 

row 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

team 

register  pointer  to  TeamStatus 

Development  ;SIMNET  :MCC; 
Mainf.MaintMac.h 

statusStrinq 

pointer  to  array  of  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

DrawText 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.16-26:  TeamDrawStatus  Information. 


2.16.4.5.9  TeamDrawLocation 

TeamDrawLocation  fills  in  the  Team  Location  field  of  the  specified  column  in  the  Team 
Table.  The  function  call  is  TeamDrawLocation(defn,  col,  row).  Table  2.16-27  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

Development:SIMNET  :libmac: 
table. h 

col 

pointer  to 

FixT  ableColumnDefn 

DevelopmentrSIMNET.libmac: 
table. h 

row 

int 

Standard  C  type. 

1  1 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

team 

register  pointer  to  TeamStatus 

Development  iSiMNET  :MCC: 
Maint;MaintMac.h 

sir 

pointer  to  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

DrawText 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.16-27:  TeamDrawLocation  Information. 

2.16.4.5.10  TeamDrawETA 

TeamDrawETA  fills  in  the  Team  ETA  field  of  the  specified  column  in  the  Team  Table.  The 
function  call  is  TeamDrawETA(defn,  col,  row).  Table  2.16-  28  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to  FixTableFieldDefn 

Development;SIMNET  rlibmac; 
table,  h 

col 

pointer  to 

FixTableColumnDefn 

DevelopmentrSIMNET  :libmac: 
table. h 

row 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

team 

register  pointer  to  TeamStatus 

Development:SIMNET:MCC: 

MaintiMaintMac.h 

str 

array  of  20  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

DTGToStrinq 

See  Section  2.22.1.15.1. 

Drawstring 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.16-28:  TeamDrawETA  Information. 

2.16.4.5.11  TeamTableHilite 

TeamTableHilite  inverts  the  text  of  the  selected  row  so  the  user  can  see  that  the  item  is 
selected.  If  the  selected  team  is  disabled  or  destroyed,  the  row  is  pickled.  The  function  call 
is  TeamTableHilite(defn,  row,  box).  Table  2.16-29  describes  the  parameters  used  and 
functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to  FixTabieFieldDfen 

DevelopmentiSIMNET  ;libmac: 
tabie.h 

row 

int 

box 

pointer  to  Rect 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 
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Variable 


team 


pattern 


destroyedPattern 


disabledPattern 


internal  Variables 


e 


register  |X)inter  to  TeamStatus 


pointer  to  Pattern 


Pattern 


Pattern 


Where  Tvpedef  Declared 


DevelopmentiSIMNET  :MCC; 
Maint:MaintMac.h 


Development;THINK  C; 
Mac  #jncludes;Quickdraw.h 


Development;THINK  C; 
Mac  #jncludes;Quickdraw.h 


Development:THINK  C; 
Mac  #includes:Quickdraw.h 


Calls 


Function  Where  Described 


PenMode  Standard  Quickdraw  function  for  Macintosh. 


PenPat  Standard  Quickdraw  function  for  Macintosh. 


PaintRect  Standard  Quickdraw  function  for  Macintosh. 


InvertRect  Standard  Quickdraw  function  for  Macintosh. 


Table  2.16-29:  TeamTableHilite  Information. 


2.16.4.5.12  UpdateTeamTableRow 

UpdateTeamTableRow  updates  the  row  displaying  a  particular  team,  team.  The  function 
call  is  UpdateTeamTableRow(team).  Table  2.16-30  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameter 


team 


Parameters 


e  Where  Typedef  Declared 


register  pointer  to  TeamStatus  Development:SIMNET ;MCC: 

MaintiMaintMac.h 


Function 


UpdateFixTableRow 


UpdateTeamTableButtons 


Calls 


Where  Described 


See  Section  2.22.1.42.2. 


See  Section  2.16.4.5.13. 


Function 


ProcessReouest 


ProcessResponse 


MainEventLoo 


CloseDisoatchDialo 


CloseStartDialo 


CancelRepair 


CloseHaltDialo 


CheckTimers 


UodateT  eamLocation 


ReoairComDleted 


DisableTeam 


EnableTeam 


Called  B 


Where  Described 


See  Section  2.16.1.1.1. 


See  Section  2.16.1.1.2. 


See  Section  2.16.2.1.5. 


See  Section  2.16.4.1.3. 


See  Section  2.16.4.6.5. 


See  Section  2.16.4.7.11. 


See  Section  2.16.4.9.5. 


See  Section  2.16.4.10.5. 


See  Section  2.16.4.11.2. 


See  Section  2.16.4.11.3. 


See  Section  2.16.4.11.4. 


See  Section  2.16.4.11.5. 


See  Section  2.16.4.11.6. 


Table  2.16-30:  UpdateTeamTableRow  Information. 
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2.16.4.5.13  UpdateTeamTableButtons 

UpdateTeamTableButtons  labels  and  enables  push  buttons  according  to  the  status  of  the 
currendy  selected  team.  The  function  call  is  UpdateTeamTableButtonsO.  Table  2.16-31 
describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Tvoedef  Declared 

team 

register  pointer  to  TeamStatus 

Development:SIMNET  :MCC: 
Maint:MaintMac.h 

i 

int 

Standard  C  type. 

theltem 

Handle 

box 

Rect 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

enable 

char 

Standard  C  type. 

repair 

register  short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

SetCTitle 

Standard  Control  Manager  function  for  Macintosh. 

EnableControl 

See  Section  2.22.1.7.2. 

DisableControl 

See  Section  2.22.1.7.1. 

1  Called  Bv  1 

Function 

Where  Described 

TeamTableFetch 

See  Section  2.16.4.5.3. 

TeamTableSelect 

See  Section  2.16.4.5.5. 

Update!  earn!  ableRow 

See  Section  2.16.4.5.12. 

Table  2.16-31:  UpdateTeamTableButtons  Information. 
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2.16.4.6  dispatch.c 

Development:SIMNET  :MCC:Maint:dispatch.c 

dispatch.c  implements  a  dialog  for  dispatching  a  maintenance  team.  Table  2.16-32 
describes  the  variables  used  by  dispatch.c. 


1  Variables  I 

Variable 

EITXSiHHHiHHH 

Where  Typedef  Declared 

assianmentBuffer 

char 

Standard  C  type. 

depotBuffer 

char 

Standard  C  type. 

locationBuffer 

MapCoordinates 

DevelopmentiSIMNET  ilibmac; 
map.h 

assignmentFields 

array  of  RBFieldOefn 

DevelopmentiSIMNET  ;libmac; 
diatoQ.h 

depotFields 

array  of  RBFieldDefn 

DevelopmentiSIMNET  ;libmac; 
dialoo.h 

dispatchCancelField 

Push  ButtonFieldDef  n 

DevelopmentiSIMNET  ilibmac; 
dialoQ.h 

locationField 

CoordinatesFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialOQ.h 

teamDispatchFields 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoo.h 

teamDispatchOialog 

Dialog  Defn 

DevelopmentiSIMNET  ilibmaci 
dialoo.h 

Table  2.16<32:  dispatch.c  Variable  Information. 

2.16.4.6.1  ShowDispatchDialog 

ShowDispatchDialog  pops  up  a  dialog  for  ordering  a  team  to  dispatch.  The  function  call  is 
ShowDispatchDialog(team,  window,  rect).  Table  2.16-33  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

team 

pointer  to  TeamStatus 

DevelopmentiSIMNET  iMCCi 
MaintiMaintMac.h 

window 

WindowPtr 

DevelopmentiTHINK  Ci 

Mac  #includesiWindowMor.h 

rect 

pointer  to  Rect 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTvpes.h 

Calls 

Function 

Where  Described 

ShowDialoo 

See  Section  2.22.1.11.1. 

ZoomTo  Window 

See  Section  2.22.1.47.4. 

ShowWindow 

Standard  Window  Manaoer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

TeamTableEvent 

See  Section  2.16.4.5.4. 

Table  2.16-33:  ShowDispatchDialog  Information. 
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2.16.4.6.2  TeamDispatchFetch 


TeamDispatchFetch  reads  the  current  values  of  the  data  structures  describing  the  Team 
Dispatch  dialog  into  the  dialog  for  display  to  the  user.  The  function  call  is 
TeamDispatchFetch(dialog).  Table  2.16-34  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

str 

array  of  50  char 

Standard  C  type. 

forcelD 

char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

DisableControl 

See  Section  2.22.1.7.1. 

Table  2.16*34:  TeamDispatchFetch  Information. 

2.16.4.6.3  TeamDispatchEvent 

TeamDispatchEvent  handles  events  for  the  Team  Dispatch  dialog.  If  the  Dispatch  button  is 
pressed,  the  destination  and  arrival  times  are  computed,  the  radio  buttons  are  updated,  and 
the  team  is  reported  as  dispatched.  !f  the  Cancel  button  is  pressed,  the  dialog  is  closed.  If 
the  ComputeETA  button  is  pressed,  the  estimated  arrival  time  is  calculated.  The  function 
call  is  TeamDispatchEvent(dialog,  itemNo).  Table  2.16-35  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

str 

array  of  20  char 

Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

ComputeETA 

See  Section  2.16.4.6.4. 

ReportDispatch 

See  Section  2.16.1.1.3. 

CloseDispatchDialog 

See  Section  2.16.4.6.5. 

DTGToString 

See  Section  2.22.1.15.1. 

SetText 

See  Section  2.22.1.11.8. 

SellText 

Standard  Dialog  Manager  function  for  Macintosh. 

SetRadioButton 

See  Section  2.22.1.11.6. 

Table  2.16-35:  TeamDispatchEvent  Information. 

2.16.4.6.4  ComputeETA 

ComputeETA  computes  the  currendy  displayed  team’s  arrival  time.  The  function  call  is 
ComputeETA().  Table  2.16-36  describes  the  internal  variables  used  and  functions  called 
using  this  function. 


I  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

distance 

long 

Standard  C  type. 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

int 

No  destination  entered. 

1 

int 

Successful. 

1  Calls  1 

Function 

Where  Described 

ShovvCaution 

See  Section  2.22.1.4.1. 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

DistBetween2Pts 

See  Section  2.22.1.23.2. 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

DTGEIapsed 

See  Section  2.22.1.15.3. 

1  Called  By  I 

Function 

Where  Described 

TeamDispatchEvent 

See  Section  2.16.4.6.3. 

Table  2,16-36:  ComputeETA  Information. 

2.16.4.6.5  CloseDispatchDialog 

CloseDispatchDialog  is  called  to  close  the  team  dispatch  dialog.  The  function  call  is 
CloseDispatchDialog(dialog).  Table  2.16-37  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialog. h 

1  1 
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1  Calls  1 

Function 

Where  Described 

Hide  Window 

Standard  Window  Manaqer  function  for  Macintosh. 

ZoomTo  Window 

See  Section  2.22.1.47.4. 

ThrowDialoo 

See  Section  2.22.1.11.3. 

UpdateTeamTableRow 

See  Section  2.16.4.5.12. 

Called  By 

Function 

Where  Described 

TeamDispatchEVent 

See  Section  2.16.4.6.3. 

Table  2.16-37:  CloseDispatchDialog  Information. 


2.16.4.7  start.c 

Development:SIMNET  :MCC:Maint:start.c 


start.c  implements  a  dialog  used  to  select  and  start  a  repair.  Table  2.16-38  describes  the 
variables  used  by  start.c. 


1  Variables  I 

Variable 

Where  Typedef  Declared 

startColumns 

array  of 

ScrollTableColumnDefn 

Development:SIMNET  ilibmac; 
scroll. h 

startTableField 

ScrollTableFieldDefn 

Development:SIMNET  ilibmac: 
scroll. h 

start  Fie  Ids 

pointer  to  array  of  FieldDefn 

Development:SIMNET  :libmac: 
dialoq.h 

startDialog 

DialogDefn 

Development  SIMNET.libmac: 
dialoq.h 

Table  2.16-38:  start.c  Variable  Information. 


2.16.4.7.1  ShowStartDialog 


ShowStartDialog  displays  the  dialog  for  selecting  and  starting  a  repair.  The  function  call  is 
ShowStartDialog(team,  window,  •  :t).  Table  2.16-39  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

team 

pointer  to  TeamStatus 

DeveiopmentiSIMNET  :MCC. 
Maint:MaintMac.h 

window 

WindowPtr 

DevelopmentTHINK  C: 

Mac  #includes;WindowMqr.h 

rect 

pointer  to  Rect 

DevelopmentTHINK  C; 

Mac  #includes:MacTvpes.h 

Calls 

Function 

Where  Described 

ShowDialoq 

See  Section  2.22.1.11.1. 

ZoomToWindow 

See  Section  2.22.1.47.4. 

ShowWindow 

Standard  Window  Manaqer  function  for  Macintosh. 

1  1 
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1  Called  By  1 

Function 

Where  Described 

TeamTableEvent 

See  Section  2.16.4.5.4. 

Table  2.16-39:  ShowStartDialog  Information. 


2.16.4.7.2  StartFetch 

StartFetch  reads  the  repair  types  table  into  the  Start  dialog  for  display  to  the  user.  The 
function  call  is  StartFetch(dialog).  Table  2.16-40  describes  the  parameters  used  and 
functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Where  Tvpedef  Declared 

dialog 

pointer  to  DiaiogState 

DevelopmentiSIMNET  ;libmac: 
dialog,  h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

repairSet 

register  pointer  to  RepairSet 

DevelopmentiSIMNET  ;MCC: 
Maint:MaintMac.h 

entry 

register 

ScrollT  ableEntrvHandle 

Development:SIMNET  :libmac: 
scroll,  h 

i 

register  short 

Standard  C  type. 

str 

array  of  50  char 

Standard  C  type. 

I  Calls  I 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

NewHandle 

Standard  Memory  Manager  function  for  Macintosh. 

InstallScrollTableEntry 

See  Section  2.22.1.21.1. 

DisableControl 

See  Section  2.22.1.7.1. 

Table  2.16-40:  StartFetch  Information. 


2.16.4.7.3  StartEvent 

StartEvent  handles  events  in  the  Start  dialog.  If  the  Start  button  is  pressed,  a  new  repair  is 
started.  If  the  Cancel  button  is  pressed,  the  Stan  dialog  is  closed.  The  function  call  is 
StartEvent(dialog,  itemNo).  Table  2.16-41  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dia.og 

pointer  to  DiaiogState 

Development;SIMNET:libmac; 
dialog. h 

itemNo 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

NewRepair 

See  Section  2.16,4.7.12. 

CloseStartDialog 

See  Section  2.16.4.7.11. 

Table  2.16-41:  StartEvent  Information. 
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2.16.4.7.4  StartSelect 

StartSelect  handles  a  mouse  click  in  the  table  of  repair  types.  The  function  call  is 
StartSelect(defn,  row,  box,  event).  Table  2.16-42  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development;SIMNET  :libmac; 
scroll.h 

row 

int 

Standard  C  tvpe. 

box 

pointer  to  Reel 

DevelopmentTHINK  C: 

Mac  #includes;MacTvpes.h 

event 

pointer  to  EventRecord 

DevelopmentiTHINK  C: 

Mac  #includes;EventMQr.h 

Calls 

Function 

Where  Described 

SelectScrollTableEntrv 

See  Section  2.22.1.37.1. 

UpdateStartButton 

See  Section  2.16.4.7.10. 

Table  2.16*42:  StartSelect  Information. 

2.16.4.7.5  StartHilite 

StartHilite  hilites  a  row  in  the  table  of  repair  types.  The  function  call  is  StartHilite(defn, 
entry,  box).  Table  2. 16-43  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development:SIMNET  ilibmac: 
scroll.h 

entry 

ScrollTableEntryHandle 

Development:SIMNET  :libmac: 
scroll.h 

box 

pointer  to  Red 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

unavailablePattern 

Pattern 

DevelopmentiTHINK  Ci 

Mac  #includesiQuickdraw.h 

1  Calls  1 

Function 

Where  Described 

PenMode 

Standard  Quickdraw  function  for  Macintosh. 

PenPat 

Standard  Quickdraw  function  for  Macintosh. 

PaintRect 

Standard  Quickdraw  function  for  Macintosh. 

InvertRect 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.16-43:  StartHilite  Information. 
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2.16.4.7.6  StartDrawDescription 


StartDrawDescription  fills  in  the  Description  field  of  the  specified  column  in  the  Start 
Table.  The  function  call  is  StartDrawDescription(defn,  col,  entry,  box).  Table  2.16-44 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevebpmentiSIMNET  ilibmac; 
scroll,  h 

col 

pointer  to 

ScrollTableColumnDefn 

Development:SIMNET  ilibmac: 
scroll.h 

entry 

register 

ScrollTableEntrvHandle 

DevebpmentiSIMNET  ilibmac: 
scroll.h 

box 

pointer  to  Rect 

DevebpmentiTHINK  C: 

Mac  #includes:macTypes.h 

1  Calls  1 

Function 

Where  Described 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.16*44:  StartDrawDescription  Information. 
2.16.4.7.7  StartDrawClass 

StartDrawClass  fills  in  the  Class  field  of  the  specified  column  in  the  Start  Table.  The 
function  call  is  StartDrawClass(defn,  col,  en^,  box).  Table  2.16-45  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevebpmentiSIMNET  ilibmaci 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

DevebpmentiSIMNET  ilibmaci 
scroll.h 

entry 

register 

ScrollTableEntrvHandle 

DevebpmentiSIMNET  ilibmaci 
scroll.h 

box 

pointer  to  Rect 

DevebpmentiTHINK  Ci 

Mac  #includesiMacTvpes.h 

Calls 

Function 

Where  Described 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.16-45:  StartDrawClass  Information. 
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2.16.4.7.8  StartDrawDuration 


StartDrawDuration  fills  in  the  Duration  field  of  the  specified  column  in  the  Start  Table. 

The  function  call  is  StartDrawDuration(defn,  col,  entry,  box).  Table  2.16-46  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  :libmac; 
scroll. h 

col 

(Xiinter  to 

ScrollTableColumnDefn 

OevelopmentiSIMNET  ilibmac; 
scroll. h 

entry 

register 

Scroll!  ableEntryHandle 

OevelopmentiSIMNET  ilibmac: 
scroll.h 

box 

pointer  to  Rect 

DevelopmentiTHINK  C: 

Mac  #includes;MacTypes.h 

internal  Variables 

Variable 

Where  Typedef  Declared 

str 

array  of  20  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 

Move 

Standard  Quickdraw  function  for  Macintosh. 

Strinq  Width 

Standard  Quickdraw  function  for  Macintosh. 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.16*46:  StartDrawDuration  Information. 


2.16.4.7.9  UpdateStartDialog 

Updates  tartDialog  updates  the  choice  of  repairs  in  the  Start  dialog  when  a  repair  is 
completed.  The  function  call  is  UpdateStartDialogQ.  Table  2.16-47  describes  the  internal 
parameters  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

savePort 

GrafPtr 

DevelopmentiTHINK  Ci 

Mac  #includesiQuickdraw.h 

Calls 

Function 

Where  Described 

Get  Port 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

InvalRect 

Standard  Window  Manaqer  function  for  Macintosh. 

UpdateStartButton 

See  Section  2.16.4.7.10. 

Called  By 

Function 

Where  Described 

RepairCompleted 

See  Section  2.16.4.11.4. 

Table  2.16-47:  UpdateStartDialog  Information. 
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2.16.4.7.10  UpdateStartButton 

UpdateStartButton  enables  or  disables  the  StartRepair  button.  The  button  is  enabled  if  and 
only  if  a  repair  type  is  selected  and  no  repairs  of  the  same  class  as  the  selected  repair  are 
currently  being  performed  by  the  subject  team.  The  function  call  is  UpdateStartButton(). 
Table  2.16-48  describes  the  internal  variables  used  and  functions  call^  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

repair 

register  pointer  to 
RepairDescriptor 

DeveiopmentiSiMNET  ;MCC: 
MaintiMaintMac.h 

1  Calls  1 

Function 

Where  Described 

EnableControl 

See  Section  2.22.1.7.2. 

DisableControl 

See  Section  2.22.1.7.1. 

1  Called  Bv  1 

Function 

Where  Described 

StartSelect 

See  Section  2.16.4.7.4. 

See  Section  2.16.4.7.9. 

Table  2.16-48:  UpdateStartButton  Information. 

2.16.4.7.11  CioseStartDialog 

CloseStartDialog  is  called  to  close  the  repair  selection  dialog,  dialog.  The  function  call  is 
CloseStanDialog(dialog).  Table  2.16-49  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DiaiogState 

Development:SIMNET  :libmac: 
dialog. h 

Calls 

Function 

Where  Described 

HideWindow 

Standard  Window  Manager  function  for  Macintosh. 

ZoomToWindow 

See  Section  2.22.1.47.4. 

ThrowDialoq 

See  Section  2.22.1.11.3. 

UpdateTeamTableRow 

See  Section  2.16.4.5.12. 

1  Caiied  Bv  1 

Function 

Where  Described 

StartEvent 

See  Section  2.16.4.7.3. 

Table  2.16-49:  CloseStartDialog  Information. 


456 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.16.4.7.12  NewRepair 

NewRepair  commences  a  new  repair,  desc,  with  team.  The  function  call  is 
NewRepair(team,  desc).  Table  2.16-50  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

team 

register  pointer  to  TeamStatus 

DevelopmentiSIMNET  :MCC: 
Maint:MaintMac.h 

desc 

pointer  to  RepairDescriptor 

DevelopmentiSIMNET  :MCC: 
MaintiMaintMac.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

repair 

register  RepairHandle 

DevelopmentiSIMNET  ;MCC: 
MaintiMaintMac.h 

repairSerialNumber 

int 

Standard  C  type. 

now 

Standard  C  type. 

dtg 

DateTimeGroup 

DevelopmentiSIMNET  ilibmaci 
dtg.h 

1  Calls  1 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manager  function  for  Macintosh. 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

DTGEIapsed 

See  Section  2.22.1.15.3. 

InstallScrollTableEntry 

See  Section  2.22.1.21.1. 

1  Called  By  I 

Function 

Where  Described 

StartEvent 

See  Section  2.16.4.7.3. 

Table  2.16-50:  NewRepair  Information. 

2.16.4.8  repairtable.c 

Development:  S IMNET :  MCC:Maint  rrepairtable.c 


repairtable.c  implements  a  dialog  displaying  a  scrolling  table  of  repairs.  Table  2. 16-5 1 
describes  the  variables  used  by  repairtable.c. 
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1  Variables  1 

Variable 

Where  Typedef  Declared 

repai  rT  ableColu  mns 

array  of 

ScrollTableColumnDefn 

DevelopmentiSIMNET  ;libmac; 
scroll.h 

repairTableFieid 

ScrollTableFieldDefn 

Development;SIMNET  ;libmac; 
scroll.h 

repairJableFieldlist 

pointer  to  array  of  FieldDefn 

Development:SIMNET  ilibmac; 
dialOQ.h 

repai  rT ableDialogDef  n 

DialogDefn 

Development;SIMNET  :libmac; 
dialOQ.h 

repairTableDialogState 

pointer  to  DialogState 

Development:SIMNET  ilibmac; 
dialOQ.h 

Table  2.16-51:  repairtable.c  Variable  Information. 
2.16.4.8.1  SetUpRepairTable 

SetUpRepairTable  initializes  the  repair  table  dialog.  The  function  call  is 
SetUpRepairTableQ.  Table  2.16-52  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

Text  Size 

Standard  Quickdraw  function  for  Macintosh. 

StrinQWidth 

Standard  Quickdraw  function  for  Macintosh. 

NewRr 

Standard  Memory  Manaoer  function  for  Macintosh. 

ShowDialoq 

See  Section  2.22.1.11.1. 

Called  By 

Function 

Where  Described 

Setup 

See  Section  2.16.4.2.1. 

Table  2.16-52:  SetUpRepairTable  Information. 
2.16.4.8.2  ShowRepairTable 

ShowRepairTable  makes  the  repair  table  dialog  visible.  The  function  call  is 
ShowRepairTable().  Table  2.16-53  describes  the  functions  called  using  this  function. 


j  Calls  1 

Function 

Where  Described 

ShowWindow 

Standard  Window  Manaqer  function  for  Macintosh. 

Select  Window 

Standard  Window  Manaqer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

TeamTableEvent 

See  Section  2.16.4.5.4. 

Table  2.16-53:  ShowRepairTable  Information. 
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2.16.4.8.3  RepairTableFetch 

RepairTableFetch  initializes  the  repair  table  dialog,  dialog.  The  function  call  is 
RepairTableFetch(dialog).  Table  2.16-54  descrites  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  ilibmac: 
dialog. h 

Calls 

Function 

Where  Described 

DisableControl 

See  Section  2.22.1.7.1. 

Table  2.16-54:  RepairTableFetch  Information. 


2.16.4.8.4  RepairTableEvent 

RepairTableEvent  handles  an  event  in  the  repair  table  dialog.  The  function  call  is 
RepairTableEvent(dialog,  itemNo).  Table  2.16-55  describes  the  parameters  used  and 
functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  ilibmac; 
dialog.h 

itemNo 

int 

Standard  C  type. 

I  Calls  I 

Function 

Where  Described 

ShowTeamTable 

See  Section  2.16.4.5.2. 

ShowCancelDialoq 

See  Section  2.16.4.9.1. 

Table  2.16-55:  RepairTableEvent  Information. 

2.16.4.8.5  RepairTableSelect 

RepairTableSelect  handles  a  mouse  click  in  the  table  of  repairs  in  progress.  The  function 
call  is  RepairTableSelect(defn,  row,  box,  event).  Table  2.16-56  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

detn 

pointer  to 

ScrollTableFieldDetn 

Development;SIMNET  :libmac: 
scroll,  h 

row 

int 

Standard  C  type. 

box 

pointer  to  Rect 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

event 

pointer  to  EventRecord 

Development;THINK  C; 

Mac  #includes:EventMgr.h 

1  1 
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1  Calls  1 

Function 

Where  Described 

SelectScrollT able  Entry 

See  Section  2.22.1.37.1. 

EnableControl 

See  Section  2.22.1.7.2. 

DisableControl 

See  Section  2.22.1.7.1. 

Table  2.16-56:  RepairTableSelect  Information. 

2.16.4.8.6  RepairTableDrawVehicle 

RepairTableDrawVehicle  fills  in  the  Vehicle  field  of  the  specified  column  in  the  Repair 
Table.  The  function  call  is  RepairTableDrawVehiclefdefn,  col,  entry,  box).  Table  2.16- 
57  describes  the  parameters  us^  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

Scroll!  ableFieldDef  n 

Development;SIMNET  ;libmac: 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

Development  iSIMNET  ilibmac; 
scroll.h 

entry 

register 

Scrol  liable  Entry  Handle 

Development:SIMNET  :libmac: 
scroll.h 

box 

pointer  to  Red 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

str 

array  of  20  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  fundion  for 
Macintosh. 

Move 

Standard  Quickdraw  function  for  Macintosh. 

StrinqWidth 

Standard  Quickdraw  function  for  Macintosh. 

DrawString 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.16-57:  RepairTableDrawVehicle  Information. 
2.16.4.8.7  RepairTableDrawLocation 

RepairTableDrawLocation  fills  in  the  Location  field  of  the  specified  column  in  the  Repair 
Table.  The  function  call  is  RepairTableDrawLocation(defn,  col,  entry,  box).  Table  2.16- 
58  describes  the  parameters  used  and  functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  :libmac; 
scroll.h 

col 

pointer  to 

Scroll!  ableColumnDef  n 

DevelopmentiSIMNET  ilibmac; 
scroll.h 

entry 

register 

ScrollTableEntrvHandle 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

box 

pointer  to  Rect 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTypes.h 

Calls 

Function 

Where  Described 

DrawText 

Standard  Ouickdraw  function  for  Macintosh. 

Table  2.16-58:  RepairTableDrawLocation  Information. 
2.16.4.8.8  RepairT ableDrawDisabled 

RepairTableDrawDisabled  fills  in  the  Disabled  field  of  the  specified  column  in  the  Repair 
Table.  The  function  call  is  RepairTableDrawDisabled(defn,  col,  entry,  box).  Table  2.16- 
59  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

col 

pointer  to 

ScrollTableCoIumnDefn 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

entry 

register 

ScrollTableEntrvHandle 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

box 

pointer  to  Rect 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTvpes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

r 

Rect 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTypes.h 

str 

array  of  20  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

TextBox 

Standard  TextEdit  function  for  Macintosh. 

Table  2.16-59:  RepairTableDrawDisabled  Information. 
2.16.4.8.9  RepairTableDrawDescription 

RepairTableDrawDescription  fills  in  the  Description  field  of  the  specified  column  in  the 
Repair  Table.  The  function  call  is  RepairTableDrawDescription(defn,  col,  entry,  box). 
Table  2.16-60  describes  the  parameters  used  and  functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development;SIMNET  :libmac; 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

Developmenf.SIMNET-.libmac; 

scroll.h 

entry 

register 

ScrollTableEntrvHandle 

DevelopmentiSIMNET  ilibmac; 
scroll.h 

box 

pointer  to  Rect 

DevelopmentTHINK  C: 

Mac  #includes:macTypes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

cp 

pointer  to  char 

Standard  C  type. 

r 

Rect 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

Calls 

Function 

Where  Described 

TextBox 

Standard  TextEdit  function  for  Macintosh. 

Table  2.16*60:  RepairTableDrawDescription  Information. 


2.16.4.8.10  RepairTableDrawETC 

RepairTableDrawETC  fills  in  the  ETC  field  of  the  specified  column  in  the  Repair  Table. 
The  function  call  is  RepairTableDrawETC(defn,  col,  entry,  box).  Table  2.1^61  describes 
the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

entry 

register 

ScrollT  able  EntryHandle 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

box 

pointer  to  Rect 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTypes.h 

Variable 


str 


Function 


DTGToStrin 


DrawStrin 


Internal  Variables 


e 


array  of  20  char 


Where  Tvoedef  Declared 


Standard  C  tvoe. 


Calls 


Where  Described 


See  Section  2.22.1.15.1. 


Standard  Quickdraw  function  for  Macintosh. 


Table  2.16*61:  RepairTableDrawETC  Information. 
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2.16.4.8.11  RepairTableDrawState 

RepairTableDrawState  fills  in  the  State  field  of  the  specified  column  in  the  Repair  Table. 
The  function  call  is  RepairTableDrawState(defn,  col,  entry,  box),  lable  2.16-62  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development;SIMNET  ;libmac: 
scroli.h 

col 

pointer  to 

ScrollTableColumnDefn 

OevelopmentiSIMNET  :libmac; 
scroli.h 

entry 

register 

ScrollTableEntrvHandle 

Development:SIMNET  :libmac; 
scroli.h 

box 

pointer  to  Red 

DevelopmentiTHINK  C: 

Mac  #includes;MacTypes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

stateStrinc 

pointer  to  array  of  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.16-62:  RepairTableDrawState  Information. 
2.16.4.8.12  UpdateRepairTableRow 

UpdateRepairTableRow  updates  the  row  displaying  a  particular  repair,  repair.  The 
function  call  is  UpdateRepairTableRow(repair).  Table  2.16-63  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

repair 

register  RepairHandie 

Development:SIMNET  :MCC; 
MaintiMaintMac.h 

1  Calls  1 

1  Function 

Where  Described 

See  Section  2.22.1.31.1. 

EnableControl 

See  Section  2.22.1.7.2. 

DisableControl 

See  Section  2.22.1.7.1. 

1  Called  By  1 

Function 

Where  Described 

CancelRepair 

See  Section  2.16.4.9.5. 

RepairCompleted 

See  Section  2.16.4.11.4. 

Table  2.16-63:  UpdateRepairTableRow  Information. 
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2.16.4.9  cancel. c 

Development:SIMNET  :MCC:Maint:cancel.c 

cancel.c  implements  a  dialog  for  cancelling  a  repair  in  progress.  Table  2.16-64  describes 
the  variables  used  by  cancel.c. 


1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

repairCancelFields 

pointer  to  array  of  FieldDein 

DevetopmentiSIMNET  ;lihmac: 
dialog. h 

repairCancelDialog 

DialogDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

Table  2.16-64:  cancel.c  Variable  Information. 

2.16.4.9.1  ShowCancelDialog 

ShowCancelDialog  pops  up  the  dialog  for  ordering  a  repair  vehicle  to  stop  travelling.  The 
function  call  is  ShowCancelDialogO.  Table  2.16-65  describes  the  functions  called  using 
this  function. 


1  Calls  1 

Function 

Where  Described 

ShowDialog 

See  Section  2.22.1.11.1. 

INI  III  mil  III  hill  — 

See  Section  2.22.1.36.1. 

1  Called  Bv  1 

Function 

Where  Described 

RepairTableEvent 

See  Section  2.16.4.8.4. 

Table  2.16-65:  ShowCancelDialog  Information. 

2.16.4.9.2  RepairCancelFetch 

RepairCancelFetch  reads  the  text  fields  into  the  Repair  Cancel  dialog.  The  function  call  is 
RepairCancelFetch(dialog).  Table  2.16-66  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac; 
dialog. h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

theltem 

Handle 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

box 

Rect 

DevelopmentTHINK  C; 

Mac  #includes;MacTypes.h 

str 

array  of  50  char 

Standard  C  type. 

464 


BBN  Systems  and  Technologies 


MCC  CSCI 


1  Calls  1 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

SetIText 

Standard  Dialog  Manager  function  for  Macintosh. 

DTGToString 

See  Section  2.22.1.15.1. 

Table  2.16-66:  RepairCancelFetch  Information. 


2.16.4.9.3  RepairCancelEvent 

RepairCancelEvent  handles  events  in  the  Repair  Cancel  dialog.  If  the  Cancel  button  is 
pressed,  the  repair  is  cancelled.  If  the  DontCancel  button  is  pressed,  the  Cancel  dialog  is 
closed.  The  function  call  is  RepairCancelEvent(dialog,  iteniNo).  Table  2.16-67  describes 
the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Variable _ Type _ Where  Typedef  Declared 

team  register  pointer  to  TeamStatus  Development;SIMNET :MCC; 


Maint:MaintMac.h 


_ _ Calls 

Function  I  Where  Uescribed 

CancelRepair _ See  Section  2.16.4.9.5. 

CloseCancelDialoq _ See  Section  2.16.4.9.4. 


Table  2.16-67:  RepairCancelEvent  Information. 

2.16.4.9.4  CloseCancelDialog 

CloseCancelDialog  is  called  to  close  the  repair  cancel  dialog,  dialog.  The  function  call  is 
CloseCancelDialog(dialog).  Table  2.16-68  describes  the  parameters  used  and  functions 
called  using  this  function. 

_ _ Parameters 

Parameter _ Type _ Where  Typedef  Declared 

dialog  pointer  to  DialogState  Development:SlMNET:libmac: 


dialoa.h 


Function _ Where  Described 

ZoomScrollTableEntry _ See  Section  2.22.1.36.1. 

Throw  Dialog _  See  Section  2.22.1.11.3. 
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1  Called  By  I 

Function 

Where  Described 

RepairCancelEvent 

See  Section  2.16.4.9.3. 

Table  2.16-68:  CloseCancelDialog  Information. 

2.16.4.9.5  CancelRepair 

CancelRepair  cancels  a  repair,  repair,  in  progress.  The  function  call  is 
CancelRepair(repair).  Table  2.1^69  descril^s  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

repair 

register  RepairHandle 

DevelopmentiSIMNET  :MCC: 
MaintrMaintMac.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

team 

register  pointer  to  TeamStatus 

Development:SIMNET  :MCC: 
Maint:MaintMac.h 

1  Calls  1 

Function 

Where  Described 

UpdateRepairTableRow 

See  Section  2.16.4.8.12. 

UpdateTeamTableRow 

See  Section  2.16.4.5.12. 

1  Called  By  1 

Function 

Where  Described 

ProcessRequest 

See  Section  2.16.1.1.1. 

RepairCancelEvent 

See  Section  2.16.4.9.3. 

Table  2.16-69:  CancelRepair  Information. 

2.16.4.10  halt.c 

Development:SIMNET:MCC:Maint:halt.c 

halt.c  implements  a  dialog  for  halting  a  maintenance  team.  Table  2. 16-70  describes  the 
varibles  used  by  halt.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

teamHaltFields 

pointer  to  array  of  FieldDefn 

Development:SIMNET  ilibmac; 
dialog. h 

teamHaltDialog 

DialogDefn 

Development:SIMNET  ilibmac: 
dialog. h 

Table  2.16-70:  halt.c  Variable  Information. 
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2.16.4.10.1  ShowHaltDialog 

ShowHaltDialog  pops  up  a  dialog  for  ordering  a  team  to  stop  travelling.  The  function  call 
is  ShowHaltDi^og(team,  window,  rect).  Table  2.16-71  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameter 


team 


window 


rect 


IEI73 


Parameters 


e 


pointer  to  TeamStatus 


WindowRr 


pointer  to  Rect 


Where  Tvoedef  Declared 


Development:SIMNET  :MCC: 
MainttMaintMac.h 


DevelopmenttTHINK  C: 

Mac  #includes;WindowMgr.h 


DevelopmentTHINK  C: 
Mac  #includes:MacTypes.h 


Function 


ShowDialo 


ZoomToWindow 


ShowWindow 


Calls 


Where  Described 


See  Section  2.22.1.11.1. 


See  Section  2.22.1.47.4. 


Standard  Window  Manager  function  for  Macintosh. 


Called  B 


Function 

Where  Described 

TeamTableEvent 

See  Section  2.16.4.5.4. 

Table  2.16>71:  ShowHaltDialog  Information. 

2.16.4.10.2  TeamHaltFetch 

TeamHaltFetch  loads  the  text  fields  into  the  Team  Halt  dialog.  The  function  call  is 
TeamHaltFetch(dialog).  Table  2.16-72  describes  the  parameters  used  and  functions  called 
using  this  function. 


Parameter 


dialog 


Variable 


str 


stateStrin 


Parameters 


pointer  to  DialogState 


Internal  Variables 


e 


array  of  50  char 


inter  to  array  of  char 


Where  Tvoedef  Declared 


Development:SIMNET  :libmac: 
dialog. h 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  type. 


Function 


UodateHaltLocation 


SetText 


DTGToStrin 


Calls 


Where  Described 


See  Section  2.16.4.10.4. 


See  Section  2.22.1.11.8. 


See  Section  2.22.1.15.1. 


Table  2.16-72:  TeamHaltFetch  Information. 
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2.16.4.10.3  TeamHaltEvent 


TeamHaltEvent  handles  events  in  the  Team  Halt  dialog.  If  the  Halt  button  is  pressed,  the 
routine  reports  that  the  team  travel  has  halted.  If  the  Cancel  button  is  pressed,  the  dialog  is 
closed,  llie  function  call  is  TeamHaltEvent(dialog,  itemNo).  Table  2.16-73  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac; 
dialOQ.h 

itemNo 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

ReportHalt 

See  Section  2.16.1.1.4. 

CloseHaltDialoa 

See  Section  2.16.4.10.5. 

Table  2.16*73:  TeamHaltEvent  Information. 

2.16.4.10.4  UpdateHaltLocation 

UpdateHaltLocation  updates  the  location  of  the  team,  team,  shown  in  the  halt  dialog.  The 
function  call  is  UpdateHaltLocation(team).  Table  2.16-74  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

team 

register  pointer  to  TeamStatus 

Development:SIMNET  :MCC: 
Maint;MaintMac.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

str 

array  of  50  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

1  Called  By  I 

Function 

Where  Described 

TeamHaltFetch 

See  Section  2.16.4.10.2. 

UpdateTeamLocation 

See  Section  2.16.4.11.3. 

Table  2.16-74:  UpdateHaltLocation  Information. 
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2.16.4.10.5  CloseHaltDialog 

CloseHaltDialog  is  called  to  close  the  team  halt  dialog,  dialog.  The  function  call  is 
CloseHaltDialog(dialog).  Table  2.16-75  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  ilibmac: 
dialog  h 

Calls 

Function 

Where  Described 

HideWindow 

Standard  Window  Manager  function  for  Macintosh. 

ZoomTo  Window 

See  Section  2.22.1.47.4. 

ThrowDialoo 

See  Section  2.22.1.11.3. 

UpdateTeamTableRow 

See  Section  2.16.4.5.12. 

Called  By 

Function 

Where  Described 

TemaHallEvent 

See  Section  2.16.4.10.3. 

Table  2.16*75:  CloseHaltDialog  Information. 

2.16.4.11  model. c 

Development:SIMNET:MCC:Maint:model.c 

model.c  contains  routines  which  model  time-based  processes  involving  maintenance  teams, 
such  as  breakdowns. 

2.16.4.11.1  InitTeamState 

InitTeamState  initializes  the  state  of  a  team,  team.  The  function  call  is  InitTeamState(team). 
Table  2.16-76  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

team 

pointer  to  TeamStatus 

DeveiopmentiSIMNET  :MCC: 
Maint:MaintMac.h 

Calls 

Function 

Where  Described 

Random 

Standard  Quickdraw  function  for  Macintosh. 

DisableTeam 

See  Section  2.16.4.11.5. 

Called  By 

Function 

Where  Described 

ProcessReguest 

See  Section  2.16.1.1.1. 

Setup 

See  Section  2.16.4.2.1. 

Table  2.16*76:  InitTeamState  Information. 
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2.16.4.11.2  CheckTimers 

CheckTimers  looks  for  time-driven  changes  in  status.  This  routine  performs  time-based 
processing  once  per  minute.  For  each  maintenance  team,  a  check  is  made  for  the  team 
having  moved,  arrived,  become  broken,  or  become  fixed.  A  check  is  made  for  the  team 
having  finished  hitching  up  a  disabled  vehicle,  and  having  completed  a  repair.  The 
function  call  is  CheckTimers().  Table  2.16-77  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

now 

unsianed  Iona 

Standard  C  type. 

i 

register  short 

Standard  C  type. 

i 

register  short 

Standard  C  type. 

team 

register  pointer  to  TeamStatus 

Developm6nt:SIMNET  ;MCC: 
MaintrMaintMac.h 

repair 

register  RepairHandle 

Development;SIMNET  ;MCC: 
MaintiMaintMac.h 

nextUpdateTime 

unsigned  long 

Standard  C  type. 

Calls 

Function 

Where  Described 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

EnableTeam 

See  Section  2.16.4.11.6. 

UpdateTeamLocation 

See  Section  2.16.4.11.3. 

DisableTeam 

See  Section  2.16.4.11.5. 

ReportDispatch 

See  Section  2.16.1.1.3. 

UpdateTeamTableRow 

See  Section  2.16.4.5.12. 

NotifyChanqeState 

See  Section  2.16.4.11.8. 

RepairCompleted 

See  Section  2.16.4.11.4. 

Table  2.16*77:  CheckTimers  Information. 


2.16.4.11.3  UpdateTeamLocation 

UpdateTeamLocation  updates  the  status  of  a  displacing  team,  team.  If  the  team  has  arrived 
at  its  destination,  any  pop-up  halt  dialogs  are  discarded  and  the  user  and  host  are  notified. 
If  the  team  has  not  yet  arrived  at  its  destination,  an  interpolation  of  its  current  location  is 
periodicatlly  updat^.  The  function  call  is  UpdateTeaniLxx:ation(now,  team).  Table  2.16- 
78  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

now 

unsigned  long 

Standard  C  type. 

team 

register  pointer  to  TeamStatus 

DevelopmentiSIMNET  :MCC: 
MaintiMaintMac.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

Pt 

pointer  to  LongPt 

DevelopmentiSIMNET  ilibmac: 
longpt.h 

str 

array  of  100  char 

Standard  C  type. 

1  1 
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\  Calls  1 

Function 

Where  Described 

Discard  PopUpDialog 

See  Section  2.16.4.11.9. 

ReportHalt 

See  Section  2.16.1.1.4. 

UpdateTeamTableRow 

See  Section  2.16.4.5.12. 

NotifyStateChanqe 

See  Section  2.16.4.11.8. 

InterpolatePoints 

See  Section  2.22.1.23.4. 

PointToMaoCoordinates 

See  Section  2.22.1.26.2. 

UpdateHattLocation 

See  Section  2.16.4.10.4. 

Called  By 

Function 

Where  Described 

CheckTimers 

See  Section  2.16.4.11.2. 

Table  2.16-78:  UpdateTeamLocation  Information. 


2.16.4.11.4  RepairCompleted 

RepairCompleted  notes  that  a  repair,  repair,  has  been  completed.  The  host  and  user  are 
notified,  and  the  repair  is  marked  as  having  been  completed.  Any  currendy  displayed 
repair  cancellation  dialog  is  closed.  If  a  repair  selection  dialog  is  currently  displayed  for 
this  team,  repairs  of  the  same  class  as  that  just  completed  should  become  available  for 
selection.  The  function  call  is  RepairCompleted(repair).  Table  2.16-79  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


repair 


Parameters 


11273 


register  RepairHandle 


Where  Tvoedef  Declared 


Development:SIMNET  ;MCC: 
Maint;MaintMac.h 


Variable 


team 


Internal  Variables 


e 


register  pointer  to  TeamStatus 


array  of  100  char 


Where  Tvoedef  Declared 


Development:SIMNET  :MCC: 
MaintiMaintMac.h 


Standard  C  type. 


Calls 

Function 

Where  Described 

ReportRepair 

See  Section  2.16.1.1.5. 

UpdateRepairTableRow 

See  Section  2.16.4.8.12. 

UpdateTeamTableRow 

See  Section  2.16.4.5.12. 

Discard  PopUpDialo 


CountCaution 


DisposDialo 


LastCaution 


ShowCaution 


See  Section  2.16.4.11.9. 


See  Section  2.16.4.7.9. 


See  Section  2.22.1.4.4. 


Standard  Dialoo  Manager  function  for  Macintosh. 


See  Section  2.22.1.4.3. 


See  Section  2.22.1.4.1. 


Called  B 


Function 

Where  Described 

CheckTimers 

See  Section  2.16.4.11.2. 

Table  2.16-79:  RepairCompleted  Information. 
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2.16.4.11.5  DisableTeam 

DisableTeam  marks  a  team,  team,  as  temporarily  disabled.  The  routine  ensures  that  no 
more  than  20%  of  the  maintenance  teams  are  disabled.  Any  current  dialog  pertaining  to  this 
team  is  taken  down.  If  the  team  was  travelling,  the  host  and  user  are  noticed  that  it  has 
stopped.  The  subsequent  repair  of  the  team  is  scheduled.  The  function  call  is 
DisableTeam(team).  Table  2.16-80  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

team 

register  pointer  to  TeamStatus 

Development:SIMNET  :MCC: 
MaintiMaintMac.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

numberDisabled 

int 

Standard  C  type. 

i 

register  short 

Standard  C  type. 

tp 

register  pointer  to  TeamStatus 

Development:SIMNET  :MCC: 
MaintiMaintMac.h 

Calls 

Function 

Where  Described 

DiscardPopUpDialoq 

See  Section  2.16.4.11.9. 

ReportHalt 

See  Section  2.16.1.1.4. 

NotifvStateChanae 

S^e  Section  2.16.4.11.8. 

UpdateTeamT  ableRow 

See  Section  2.16.4.5.12. 

ScheduleDisableEvent 

See  Section  2.16.4.11.7. 

Called  By 

Function 

Where  Described 

InitTeamState 

See  Section  2.16.4.11.1. 

CheckTimers 

See  Section  2.16.4.11.2. 

Table  2.16-80:  DisableTeam  Information. 


2.16.4.11.6  EnableTeam 

EnableTeam  reenables  a  team,  team,  that  has  been  repaired.  The  user  is  notified  that  the 
team  is  no  longer  disabled,  and  the  subsequent  breakdown  of  the  team  is  scheduled.  The 
function  call  is  EnableTeam(team).  Table  2.16-81  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

team 

pointer  to  TeamStatus 

Development:SIMNET  :MCC; 
MaintiMaintMac.h 

1  1 

472 


BBN  Systems  and  Technologies _ _ MCC  CSCI 


1  Calls  1 

Function 

Where  Described 

NotifyStateChange 

See  Section  2.16.4.11.8. 

UpdateTeamTableRow 

See  Section  2.16.4.5.12. 

ScheduleDisableEvent 

See  Section  2.16.4.11.7. 

Called  Bv 

Function 

Where  Described 

CheckTimers 

See  Section  2.16.4.11.2. 

Table  2.16-81:  EnableTeam  Information. 


2.16.4.11.7  ScheduleDisableEvent 

ScheduleDisableEvent  determines  the  length  of  time  before  a  team  next  becomes  broken  or 
fixed.  The  function  call  is  ScheduleDisableEvent(team,  diceRange,  numberDie).  Table 
2.16-82  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

team 

register  pointer  to  TeamStatus 

DevelopmentiSIMNET  :MCC: 
MaintiMaintMac.h 

diceRange 

int 

Standard  C  type. 

numberDie 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

dice 

register  short 

Standard  C  type. 

i 

register  short 

Standard  C  type. 

Calls 

Function 

Where  Described 

Random 

Standard  Quickdraw  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

DisableTeam 

See  Section  2.16.4.11.5. 

EnableTeam 

See  Section  2.16.4.11.6. 

Table  2.16-82:  ScheduleDisableEvent  Information. 


2.16.4.11.8  NotifyStateChange 

NotifyStateChange  notifies  the  user  of  a  change  in  the  state  of  a  team,  team,  state  is  the 
current  state  of  the  team.  The  function  call  is  Notify StateChange(team,  state).  Table  2.16- 
83  describes  the  parameters  used,  and  functions  called  using  this  function. 


Parameter 


team 


Parameters 


register  pointer  to  TeamStatus 


inter  to  char 


Where  Tvoedef  Declared 


DevelopmentiSIMNET  :MCC: 
MaintiMaintMac.h 


Standard  C  type. 
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Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

cp 

pointer  to  char 

Standard  C  type. 

strUOOl 

char 

Standard  C  type. 

Calls 

Function 

Where  Described 

CountCaution 

See  Section  2.22.1.4.4. 

DisposDialOQ 

Standard  Dialoa  Manaoer  function  for  Macintosh. 

LastCaution 

See  Section  2.22.1.4.3. 

ShowCaution 

See  Section  2.22.1.4.1. 

Called  By 

Function 

Where  Described 

ProcessRequest 

See  Section  2.16.1.1.1. 

CheckTimers 

See  Section  2.16.4.11.2. 

UpdateTeamLocation 

See  Section  2.16.4.11.3. 

DisableTeam 

See  Section  2.16.4.11.5. 

EnableTeam 

See  Section  2.16.4.11.6. 

Table  2.16-83:  NotifyStateChange  Information. 
2.16.4.11.9  DiscardPopUpDialog 

DiscardPopUpDialog  discards  any  pop-up  dialog  for  commanding  a  team,  team,  or 
cancelling  a  repair.  The  function  c^  is  DiscardPopUpDialog(team).  Table  2.16-84 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

team 

register  pointer  to  TeamStatus 

Deyelopment;SIMNET  :MCC: 
Maint;MaintMac.h 

Called  By 

Function 

Where  Described 

ProcessRequest 

See  Section  2.16.1.1.1. 

ProcessResponse 

See  Section  2.16.1.1.2. 

UpdateTemaLocation 

See  Section  2.16.4.11.3. 

RepairCompleted 

See  Section  2.16.4.11.4. 

DisableTeam 

See  Section  2.16.4.11.5. 

Table  2.16-84:  DiscardPopUpDialog  Information. 
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2.16.4.12  data.c 

Development:SIMNET  :MCC:Maint:data.c 

data.c  contains  data  definitions  for  the  Maintenance  application.  Table  2.16-85  describes 
the  variables  used  by  data.c. 


Internal  variables 


Variable 


application 


authors 


simnetMl  Repairs 


simnetMt  RepairSet 


simnetM2Repairs 


s'mnetM2RepairSet 


genericRepairs 


genericRepairSet 


armor!  eamRepairSet 


armorleamCapabilities 


maintleams 


selectedTeam 


currentleam 


currentRepair 


zoomBase  Window 


zoomBaseRect 


popUpDialogState 


I 


closePopUpDialo 


battleScheme 


bnForcelD 


companyForcelD 


startupComplete 


repairOepot 


repairClassName 


_go 

inter  to  char 

JO 

inter  to  char 

po 

inter  to  char 

array  of  RepairDescnptor 


RepairSet 


array  of  RepairDescnptor 


RepairSet 


array  of  RepairDescriptor 


RepairSet 


pointer  to  RepairSet 


TeamCapabilities 


array  of 

numberBnRepairVehicles 

TeamStatus 


short 


pointer  to  TeamStatus 


RepairHandle 


WindowRr 


pointer  to  DialogState 


void  function  call 


char 


char 


array  of 

maxNumberCompanies  char 


char 


MapCoordinates 


113 


inter  to  array  of  char 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  type. 


Standard  C  type. 


Development;SIMNET  :MCC: 
MaintiMaintMac.h 


Development:SIMNET  ;MCC; 
Maint:MaintMac.h 


DevelopmentiSIMNET  :MCC: 
MaintiMaintMac.h 


DevelopmentiSIMNET  :MCC: 
MaintiMaintMac.h 


DevelopmentiSIMNET  iMCCi 
MaintiMaintMac.h 


DevelopmentiSIMNET  iMCCi 
MaintiMaintMac.h 


DevelopmentiSIMNET  iMCCi 
MaintiMaintMac.h 


DevelopmentiSIMNET  iMCCi 
MaintiMaintMac.h 


DevelopmentiSIMNET  iMCCi 
MaintiMaintMac.h 


Standard  C  type. 


DevelopmentiSIMNET  iMCCi 
MaintiMaintMac.h 


Development  iSI  M  N  ETiMCC  i 
MaintiMaintMac.h 


DevelopmentiTHINK  Ci 
Mac  #includesiWindowMar.h 


DevelopmentiTHINK  Ci 
Mac  #includesiMacTypes.h 


DevelopmentiSIMNET  ilibmaci 
dialOQ.h 


Standard  C 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


DevelopmentiSIMNET  ilibmaci 
map.h 


Standard  C  type. 


Table  2.16-85:  data.c  Variable  Information. 
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2.16.5  Appearance  of  Maint  User  Interface 


2.16.5.1  Maint  Pictures 

E)evelopmeni:SIMNET:MCC:Maint:Maini  Pictures 

Maint  Pictures  contains  resources  that  determine  the  appearance  of  the  Maint  application’s 
user  interface. 
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2.17  The  FSE  (Fire  Support  Element)  Console 


user  Status 

Interface  of 

for  Artillery 

Controlling  Batteries 

Indirect  1.17.2 

Fire 

Missions  - 

1.17.1 


Displace¬ 

ment 

of 

Artillery 

Batteries 

1.17.3 


FSF  Console 
1.17 


Dialog 
Lists 
of  Target 
and 


Scheduled  Batteries 

I  Missions  1.17.5 


Model 

Operation 

of 

Artillery 


-adjust.c 

1.17.1.1 


-nre.c 

1.17.1.2 


-battery. c  -^isplace.c  -^^nodel.c 

1.17.2.1  1.17.3.1  1.17.5.1 

-status. c  1— move.c  — firetarget.c  Lujnits.c 

1.17.2.2  1.17.3.2  1.17.4.1  1.17.5.2 

— fpftarget.c 
1.17.4.2 


-FSEh 

1.17.7.1 


-version.h 

1.17.7.3 


-file.c 

1.17.8.1 


-FSE 

Pictures 

1.17.6.1 


rPSEMac.h  -Joad.c 
1.17.7.2  1.17.8.2 


-main.c 

1.17.8.3 


-ne.c 

1.17.1.3 


■echedule.c 

1.17.4,3 


-data.c 

1.17.7.4 


-menu.c 

1.17.8.4 


Jpf.c 

1.17.1.4 


jnission.c 

1.17.8.5 


-new.c 
1.1/. 1.5 


-setups 

1,17.8.6 


-targets 

1.17.1.6 


Figure  2.17-1:  FSE  (Fire  Support  Element)  Console  Structure. 
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2.17.1  User  Interface  for  Controlling  Indirect  Fire  Missions 


2.17.1.1  adjust.c 

Development:SIMNET:MCC:FSE:adjust.c 

adjust.c  implements  adjust  fire  missions.  Table  2.17-1  describes  the  variables  used  in 
adjust.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

adjustDialogDefn 

extern  DialogDefn 

Development:SIMNET  :libmac; 
dialOQ.h 

adjustOTDirectionField 

extern  NumberFieWDefn 

Developmenf.SIMNET  ilibmac; 
dialoo.h 

riqhtButton 

char 

Standard  C  type. 

drooButton 

char 

Standard  C  type. 

leftRiahtDistance 

int 

Standard  C  type. 

addDropDistance 

int 

Standard  C  type. 

adjustOTDirectionField 

NumberFieldDefn 

Development:SIMNET  :libmac: 
dialOQ.h 

adjustRBFields 

array  of  RBFieldDefn 

Development:SIMNET  :libmac; 
dialOQ.h 

adjust  Distance  Fields 

array  of  NumberFieldDefn 

DevelopmentrSIMNET  ilibmac: 
dialOQ.h 

adjustFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialOQ.h 

adjustDialogDefn 

DialogDefn 

Development:SIMNET  :libmac: 
dialOQ.h 

sinTable 

array  of  int 

Standard  C  type. 

Table  2.17-1:  adjust.c  Variable  Information. 

2.17.1.1.1  ShowAdjust 

Show  Adjust  displays  the  adjust  fire  dialog.  The  function  call  is  ShowAdjust().  Table 
2.17-2  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

BatterySelectionViable 

See  Section  2.17.5.1.9. 

ShowDialOQ 

See  Section  2.22.1.11.1. 

Show  Window 

Standard  Window  Manager  function  for  Macintosh. 

Table  2.17-2;  ShowAdjust  Information. 
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2.17.1.1.2 


AdjustEvent 


AdjustEvent  handles  events  in  the  Adjust  Fire  dialog.  If  Fire  button  is  pressed,  the  routine 
first  checks  that  the  right  combination  of  buttons  and  distances  were  us^  and  that  the 
mandatory  fields  were  filled  in.  The  routine  then  computes  a  new  target  location,  starts  the 
guns  firing  adjust  rounds,  and  updates  the  display.  If  the  FFEB  button  is  pressed,  the 
Adjust  Fire  dialog  is  taken  down  and  the  Fire  For  Effect  dialog  is  popped.  If  the  Cancel 
button  is  pressed,  the  Adjust  Fire  dialog  is  taken  down.  The  function  call  is 
AdjustEvent(dialog,  itemNo).  Table  2.17-3  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  ilibmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

pt 

LongPt 

Development:SIMNET  ilibmac: 
longpt.h 

Calls 

Function 

Where  Described 

ShowCaution 

See  Section  2.22.1.4.1. 

CheckMandatorvFields 

See  Section  2.22.1.13.1. 

ComouteAdjustment 

See  Section  2.17.1.1.3. 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

FireVollev 

See  Section  2.17.5.1.2. 

UpdateMissionDisplav 

See  Section  2.17.8.5.5. 

Throw  Dialog 

See  Section  2.22.1.11.3. 

ShowFFEWith  Adjust 

See  Section  2.17.1.3.2. 

SellText 

Standard  Dialog  Manager  function  for  Macintosh. 

Table  2.17-3:  AdjustEvent  Information. 

2.17.1.1.3  ComputeAdJustment 

ComputeAdjustmeni  applies  an  adjustment  to  a  target  location.  The  function  call  is 
ComputeAdjustment(pt,  angle,  IrButton,  IsDistance,  adButton,  adDistance).  Table  2.17-4 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

pt 

pointer  to  LongR 

DevelopmentiSIMNET  ;libmac: 
longpt.h 

angle 

int 

Standard  C  type. 

IrButton 

int 

Standard  C  type. 

IrDistance 

int 

Standard  C  type. 

adButton 

int 

Standard  C  type. 

adDistance 

int 

Standard  C  type. 

1  1 
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Variable 


sin 


cos 


Function 


iuslEvent 


NewMissionEvent 


FFEEvent 


Internal  Variables 


e 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  type. 


Calls 

Function 

Where  Described 

ApproximateSin 

See  Section  2.17.1.1.4. 

ApproximateCos 

See  Section  2.17.1.1.5. 

Called  B 


Where  Described 


See  Section  2.17.1.1.2. 


See  Section  2.17.1.5.2. 


See  Section  2.17.1.3.3. 


Table  2.17-4:  ComputeAdjustment  Information. 
2.17.1.1.4  ApproximateSin 


ApproximateSin  computes  the  approximate  sin  of  angle.  The  sins  for  various  angles  are  in 
sinTable.  The  function  call  is  ApproximateSin(angle).  Table  2.17-5  describes  the 
parameter  used  by  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

anqie 

int 

Standard  C  type. 

Function 

Where  Described 

ComputeAdjustment 

See  Section  2.17.1.1.3. 

Table  2.17-5:  ApproximateSin  Information. 
2.17.1.1.5  ApproximateCo.s 


ApproximateCos  computes  the  approximate  cos  of  angle.  The  function  call  is 
ApproximateCos(angle).  Table  2.17-6  describes  the  parameter  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

anqie 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

cos 

reqister  int 

Standard  C  type. 

a 

reqister  int 

Standard  C  type. 
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Function 

Where  Described 

ComputeAdiustment 

See  Section  2.17.1.1.3. 

Table  2.17-6:  ShowAdjust  Information. 


2.17.1.2  fire.c 

Development:  SIMNET  :MCC:FSE:fire.c 

fire.c  implements  a  dialog  presenting  the  status  of  a  indirect  fire  mission.  Table  2.17-7 
describes  the  variables  used  in  fire.c. 


1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

fireDialogDefn 

extern  DialogDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

fireDialog 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialog. h 

fireRect 

Rect 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

buttonDefn[5][2] 

matrix  of  struct  button  Defn 

DevelopmentiSIMNET  :MCC: 
FSE:fire.c 

lireEndField 

PushButtonFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

fireObserverField 

TextFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialog,  h 

FireOTDirectionField 

NumberFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

fireAmmo  Fields 

array  of  RBFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

fireBatteryFields 

array  of  CBFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

fireFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

fireDialogDefn 

DialogDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

Table  2.17-7:  fire.c  Variable  Information. 


2.17.1.2.1  SetUpFireMission 


SetUpFireMission  initializes  a  dialog  for  displaying  the  fire  mission  status.  The  function 
call  is  SetUpFireMission().  Table  2.17-8  describes  the  functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

ShowDialOQ 

See  Section  2.22.1.11.1. 

EstablishBatterySelection 

See  Section  2.17.5.2.1. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

Table  2.17-8:  SetUpFireMission  Information. 

2.17.1.2.2  GetFireDialogInfo 

GetFireDialogInfo  returns  information  about  the  fire  dialog.  The  function  call  is 
GetFireDialogInfo(dialog,  firstltemNo).  Table  2.17-9  describes  the  parameters  used  by 
this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogPtr 

Development;THINK  C: 

Mac  #includes;DialoaMgr.h 

lirstltemNo 

pointer  to  int 

Standard  C  type. 

Called  By 

Function 

Where  Described 

UpdateBatterySelection 

See  Section  2.17.5.2.2. 

Table  2.17-9:  GetFireDialogInfo  Information. 


2.17.1.2.3  OpenFireMission 

OpenFireMission  opens  an  icon  to  display  the  status  of  the  fire  mission,  m.  The  function 
c^l  is  OpenFireMission(m).  Table  2.17-10  describes  the  parameter  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

m 

register  pointer  to  Mission 

Development;SIMNET;MCC; 

FSE:FSEMac.h 

Calls 

Function 

Where  Described 

Select  Window 

Standard  Window  Manager  function  for  Macintosh. 

ZoomMissionIcon 

See  Section  2.17.2.2.7. 

ShowFireMission 

See  Section  2.17.1.2.4. 

Called  By 

Function 

Where  Described 

OpenMission 

See  Section  2.17.8.5.3. 

Table  2.17-10: 


OpenFireMission  Information. 
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2.17.1.2.4  ShowFireMission 

ShowFireMission  makes  the  fire  mission  status  dialog  visible.  The  function  call  is 
ShowFireMission(m).  Table  2.17-1 1  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

m 

pointer  to  Mission 

Development:SIMNET  ;MCC; 
FSE:FSEMac.h 

1  Calls  1 

Function 

Where  Described 

LoadFireBuffers 

See  Section  2.17.1.2.6. 

Update  Fi  re  Oialoq 

See  Section  2.17.1.2.7. 

UpdateBatterySelection 

See  Section  2.17.5.2.2. 

Select  Window 

Standard  Window  Manaaer  function  for  Macintosh. 

ShowWindow 

Standard  Window  Manaaer  function  for  Macintosh. 

1  Called  By  I 

Function 

Where  Described 

OpenFireMission 

See  Section  2.17.1.2.3. 

NewMissionEvent 

See  Section  2.17.1.5.2. 

Table  2.17-11:  ShowFireMission  Information. 

2.17.1.2.5  FireEvent 

FireEvent  handles  events  in  the  Fire  Mission  dialog.  If  the  End  button  is  pressed,  the 
mission  is  ended.  If  the  OK  button  is  pressed,  the  dialog  is  taken  down.  The  function  call 
is  FireEvent(dialog,  itemNo).  Table  2.17-12  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

f 

FireTargetHandle 

Development:SIMNET  ;MCC: 
FSE:  FSEMac.h 

i 

int 

Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

EndFireMission 

See  Section  2.17.1.2.10. 

HideWindow 

Standard  Window  Manaoer  function  for  Macintosh. 

ZoomMissionIcon 

See  Section  2.17.2.2.7. 

NewFireTaraet 

See  Section  2.17.4.1.1. 

ShowFireTarqet 

See  Section  2.17.4.1.11. 

ToqaleBatterv 

See  Section  2.17.8.5.4. 

Table  2.17-12:  FireEvent  Information. 

2.17.1.2.6  LoadFireBuffers 

LoadFireBuffers  makes  field  definitions  for  the  fire  mission  dialog  point  to  locations  of 
values  for  the  appropriate  mission.  The  function  call  is  LoadFireBuffers().  Table  2. 17- 1 3 
describes  the  intern^  variables  used  and  function  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

m 

pointer  to  register  Mission 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

i 

register  short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

1  Called  Bv  1 

Function 

Where  Described 

ShowFireMission 

See  Section  2.17.1.2.4. 

Table  2.17-13:  LoadFireBuffers  Information. 

2.17.1.2.7  IJpdateFireDialog 

UpdateFireDialog  updates  the  dialog  displaying  detailed  status  about  a  fire  mission.  The 
target  location  is  filled  in,  the  fuze  selection  is  enabled  or  disabled,  the  status  description  is 
filled  in,  and  the  push  buttons  are  labeled  for  the  proper  state.  The  function  call  is 
UpdateFireDialogO.  Table  2.17-14  describes  the  functions  called  using  this  function. 


1  internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

m 

register  pointer  to  Mission 

DevelopmentiSIMNET  :MCC: 
FSE:FSEMac.h 

CP 

register  pointer  to  char 

Standard  C  type. 

i 

int 

Standard  C  type. 

ctl 

ControlHandle 

DevelopmentTHINK  C; 

Mac  #includes;ControlMgr.h 

box 

Rect 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

buf 

array  of  80  char 

Standard  C  type. 

1  1 
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1  Calls  1 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

EnableControl 

See  Section  2.22.1.7.2. 

DisabieControl 

See  Section  2.22.1.7.1. 

UpdateFireState 

See  Section  2.17.1.2.8. 

GetDitem 

Standard  Oialoo  Manaoer  function  for  Macintosh. 

HideControl 

Standard  Control  Manaqer  function  for  Macintosh. 

ShowControl 

Standard  Control  Manaqer  function  for  Macintosh. 

SetCTitile 

Standard  Control  Manaqer  function  for  Macintosh. 

UpdateDialoq 

See  Section  2.22.1.11.2. 

Called  Bv 

Function 

Where  Described 

ShowFireMission 

See  Section  2.17.1.2.4. 

UpdateMissionDisplay 

See  Section  2.17.8.5.5. 

Table  2.17-14:  UpdateFireDialog  Information. 
2.17.1.2.8  UpdateFireState 

UpdateFireState  updates  the  display  of  a  fire  mission’s  state.  The  function  call  is 
UpdateFireStateQ.  Table  2.17-15  describes  the  function  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

m 

register  pointer  to  Mission 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

cp 

reqister  pointer  to  char 

Standard  C  type. 

buf 

array  of  80  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

Called  By 

Function 

Where  Described 

UpdateFireDialoq 

See  Section  2.17.1.2.7. 

UpdateMissionState 

See  Section  2.17.8.5.6. 

Table  2.17-15:  UpdateFireState  Information. 

2.17.1.2.9  UpdateOTDirection 

Up^teOTDirection  updates  the  display  of  the  OT  Direction  in  the  mission  status  dialog. 
This  function  is  called  by  the  libmac  dialog  code  as  a  field  validation  routine.  It  always 
returns  1.  The  function  call  is  UpdateOTDircction(dialog,  fp,  str).  Table  2.17-16 
describes  the  parameters  used  and  function  called  using  this  function. 


BBN  Systems  and  Technologies 


MCC  CSCI 


1  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  ilibmac: 
dialOQ.h 

Ip 

pointer  to  TypeInFieldDefn 

Development;SIMNET  rlibmac; 
dialoq.h 

str 

pointer  to  char 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

1 

int 

Always  returned. 

Calls 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

Table  2.17-16:  UpdateOTDirection  Information. 

2.17.1.2.10  EndFireMission 

EndFireMission  ends  a  fire  mission,  m.  A  dialog  is  brought  down,  displaying  the  mission, 
if  any.  The  batteries  and  the  mission  descriptor  aregdgf  freed.  The  function  call  is 
EndFireMission(m).  Table  2.17-17  describes  the  parameters  used  and  functions  called 
using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

m 

pointer  to  Mission 

Development:SIMNET:MCC: 

FSE:FSEMac.h 

Calls 

Function 

Where  Described 

AppIvToBatteries 

See  Section  2.17.5.1.5. 

EndMission 

See  Section  2.17.8.5.2. 

Hide  Window 

Standard  Window  Manager  function  for  Macintosh. 

ZoomMissionlcon 

See  Section  2.17.2.2.7. 

Called  By 

Function 

Where  Described 

Fire  Event 

See  Section  2.17.1.2.5. 

FireVolley 

See  Section  2.17.5.1.2. 

Table  2.17-17:  EndFireMission  Information. 
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2.17.1.3  ffe.c 

Development:SIMNET:MCC:FSE:ffe.c 

ffe.c  implements  dialogs  controlling  fire  for  effect  missions.  Table  2.17-18  describes  the 
variables  used  in  ffe.c. 


1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

ffeOialogDefn 

externOialogDefn 

Development:SIMNET  :libmac; 
dialog. h 

ffeOTDirectionField 

extern  NumberFiekjDefn 

Development:SIMNET  ilibmac; 
dialoq.h 

ffeRoundsField 

extern  NumberFieldDefn 

Development:SIMNET  :libmac; 
dialoq.h 

riqhtButton 

char 

Standard  C  type. 

dropButton 

char 

Standard  C  type. 

leftRjqhtDistance 

int 

Standard  C  type. 

addOropDistance 

int 

Standard  C  type. 

controlBuffer 

char 

Standard  C  type. 

ffeOTDirectionField 

NumberFieldDefn 

Development;SIMNET  :libmac; 
dialoq.h 

ffeRBFields 

array  of  RBFieldDefn 

Development.SIMNET.libmac; 

dialoq.h 

ffeDistanceFields 

array  of  NumberFieldDefn 

Development;SIMNET  ;libmac; 
dialoq.h 

ffeRoundsField 

NumberFieldDefn 

Development;SIMNEt:libmac: 

dialoq.h 

ffeControlFields 

array  of  RBFieldDefn 

Development:SIMNET  ;libmac: 
dialoq.h 

ffeFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  rlibmac: 
dialoq.h 

ffeOialogDefn 

Dialog  Defn 

Development:SIMNET  :libmac: 
dialoq.h 

Table  2.17-18:  ffe.c  Variable  Information. 

2.17.1.3.1  ShowFFE 

ShowFFE  displays  the  Fire  For  Effect  dialog.  The  function  call  is  ShowFFE().  Table 
2.17-19  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

BatterySelection  Viable 

See  Section  2.17.5.1.9. 

ShowFFEWithAdjust 

See  Section  2.17.1.3.2. 

Table  2.17-19:  ShowFFE  Information. 


2.17.1.3.2  ShowFFEWithAdjust 

ShowFFEWithAdjust  shows  the  Fire  For  Effect  dialog  with  partially  completed 
adjustment.  The  function  call  is  S howFFE WithAdj ust(lrButton ,  IrDistance,  adButton, 
adDistance).  Table  2.17-20  describes  the  parameters  used  and  functions  called  using  this 
function. 
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Parameters 


Parameter 


IrButton 


IrDistance 


adButton 


adDistance 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Function 


ShowDialo 


ShowWindow 


Calls 


Where  Described 


See  Section  2.22.1.11.1. 


Standard  Window  Manaaer  function  for  Macintosh. 


Called  B 


Function 

Where  Described 

AdiustEvent 

See  Section  2.17.1.1.2. 

ShowFFE 

See  Section  2.17.1.3.1. 

Table  2.17-20:  ShowFFEWithAdjust  Information. 

2.17.1.3.3  FFEEvent 

FFEEvent  handles  events  in  the  Fire  For  Effect  dialog.  If  the  Fire  button  is  pressed,  the 
routine  checks  for  validity  of  the  data,  updates  the  coordinates  (in  case  the  target  changed), 
computes  the  new  target  loaction,  and  starts  the  guns  firing  volleys.  If  the  Cancel  button  is 
pressed,  the  dialog  is  taken  down.  The  function  call  is  FFEEvent(dialog,  itemNo).  Table 
2.17-21  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development;SIMNET;libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Variable 


Pt 


Internal  Variables 


e 


LongPt 


Where  Tvoedef  Declared 


Development:SIMNET  ;libmac: 
.h 


Function 


ShowCaution 


PointToMapCoordinales 


CheckMandatorvFields 


laam 


ThrowDialo 


SellText 


Calls 


Where  Described 


See  Section  2.22.1.4.1. 


See  Section  2.22.1.26.2. 


See  Section  2.22.1.13.1. 


See  Section  2.17.5.1.2. 


See  Section  2.17.1.1.3. 


See  Section  2.17.8.5.5. 


See  Section  2.22.1.11.3. 


Standard  Dialoq  Manaaer  function  for  Macintosh. 


Table  2.17-21:  FFEEvent  Information. 
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2.17.1.3.4  CommenceFFE 

CommenceFFE  starts  a  Fire  For  Effect  waiting  for  an  “at  my  command”.  The  function  call 
is  CommenceFFE().  Table  2.17-22  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

FireVoltei 

See  Section  2.17.5.1.2. 

UpdateMissionDisplay 

See  Section  2.17.8.5.5. 

Table  2.17-22:  CommenceFFE  Information. 

2.17.1.3.5  CancelAtCommand 

CancelAtCommand  cancels  a  Fire  For  Effect,  which  was  waiting  for  an  “at  my  command”. 
The  function  call  is  CancelAtCommand().  Table  2.17-23  describes  the  function  called 
using  this  function. 


1  Calls  1 

1  Function 

Where  Described 

See  Section  2.17.8.5.5. 

Table  2.17-23:  CancelAtCommand  Information. 

2.17.1.3.6  CheckFiring 

CheckFiring  cancels  a  Fire  For  Effect  in  progress.  If  the  mission  was  scheduled  in 
advance,  it  is  disassociated  from  the  fire  mission  schedule  and  placed  under  manual 
control.  The  function  call  is  CheckFiringQ.  Table  2.17-24  describes  the  functions  called 
using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

schedTableField 

extern  ScrollTableFieldDefn 

Development:SIMNET  :libmac: 
scroll. h 

1  Calls  1 

Function 

Where  Described 

ApplyToBatteries 

See  Section  2.17.5.1.5. 

See  Section  2.17.8.5.5. 

1  SetSchedMission 

See  Section  2.17.4.3.16. 

Table  2.17-24:  CheckFiring  Information. 


2.17.1.4  fpf.c 

Development:SIMNET:MCC:FSE:fpf.c 

fpf.c  implements  dialogs  controlling  final  protective  fire  missions.  Table  2.17-25  describes 
the  variables  used  in  fpf  c. 
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1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

fpfDialogDefn 

extern  DialogDefn 

Development:SIMNET  ilibmac: 
dialog.h 

fpfdialog 

pointer  to  DiaiogState 

Development:SIMNET  :libmac: 
dialog.h 

fpfRect 

Red 

Development:THINK  C: 

Mac  #includes;MacTvDes.h 

fpfEnd  Field 

PushButtonFieldDefn 

Development:SIMNET  :libmac: 
dialog.h 

fptObserverField 

TextFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

IpfNumberField 

NumberFieWDefn 

DevelopmentiSIMNETilibmac; 

dialog.h 

fpfBattery  Fields 

array  of  CBFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

fpfFieldList 

array  of  pointer  to  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

fpfDialogDefn 

DialogDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

Table  2.17-25:  fpf.c  Variable  Information. 
2.17.1.4.1  SetUpFPFMission 


SetUpFPFMission  initializes  a  dialog  for  displaying  FPF  mission  status.  The  function  call 
is  SetUpFPFMissionQ.  Table  2.17-26  describes  the  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

1  Calls  1 

1  Function 

Where  Described 

See  Section  2.22.1.11.1. 

1  EstablishBatterySelection 

See  Section  2.17.5.2.1. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

Table  2.17-26: 


SetUpFPFMission  Information. 
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2.17.1.4.2  GetFPFDialogInfo 

GetFPFDialogInfo  returns  information  about  the  FPF  dialog.  The  function  call  is 
GetFPFDialogInfo(dialog,  firstltemNo).  Table  2.17-27  describes  the  parameters  used  by 
this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

dialog 

pointer  to  DialogRr 

DevelopmentiTHINK  C: 

Mac  #includes;DialoaMar.h 

firstltemNo 

pointer  to  int 

Standard  C  type. 

1  Called  Bv  1 

Function 

Where  Described 

UpdateBatterySelection 

See  Section  2.17.5.2.2. 

Table  2.17-27:  GetFPFDialogInfo  Information. 

2.17.1.4.3  ShowNewFPFMission 

ShowNewFPFMission  puts  up  a  dialog  for  a  new  FPF  mission.  The  function  call  is 
ShowNewFPFMission().  Table  2.17-28  describes  the  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

m 

pointer  to  Mission 

Development;SIMNET  :MCC; 
FSE:FSEMac.h 

I  Calls  1 

Function 

Where  Described 

NewMission 

See  Section  2.17.8.5.1. 

RedrawMissionIcon 

See  Section  2.17.2.2.5. 

ShowFPFMission 

See  Section  2.17.1.4.5. 

1  Called  By  I 

Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17-28:  ShowNewFPFMission  Information. 

2.17.1.4.4  OpenFPFMission 

OpenFPFMission  opens  an  icon  to  display  the  status  of  an  FPF  mission,  m.  The  function 
call  is  OpenFPFMission(m).  Table  2.17-29  describes  the  parameter  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

m 

pointer  to  Mission 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

1  1 
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Function 


Se.ectWindow 


ZoomMissionIcon 


ShowFPFMission 


Calls 


Where  Described 


Standard  Window  Manaoer  function  for  Macintosh 


See  Section  2.17.2.2.7. 


See  Section  2.17.1.4.5. 


Called  B 


Function 

Where  Described 

OpenMission 

See  Section  2.17.8.5.3. 

Table  2.17-29:  OpenFPFMission  Information. 

2.17.1.4.5  ShowFPFMission 

ShowFPFMission  makes  an  FPF  mission  status  dialog  visible.  The  function  call  is 
ShowFPFMission(m).  Table  2. 17-30  describes  the  parameter  used  and  functions  called 
using  this  function. 


Parameters 


Parameter 


m 


Function 


LoadFPFBuffers 


UpdafeFPFDialo 


ateBattervSelection 


Select  Window 


Show  Window 


Function 


ShowNewFPFMission 


OoenFPFMission 


pointer  to  Mission 


Where  Tvoedef  Declared 


Development'.SlMNET  iMCC; 
FSEiFSEMac.h 


Calls 


Where  Described 


See  Section  2.17.1.4.8. 


See  Section  2.17.1.4.9. 


See  Section  2.17.5.2.2. 


Standard  Window  Manaoer  function  for  Macintosh. 


Standard  Window  Manager  function  for  Macintosh. 


Called  B 


Where  Described 


See  Section  2.17.1.4.3. 


See  Section  2.17.1.4.4. 


Table  2.17-30:  ShowFPFMission  Information. 
2.17.1.4.6  FPFEvent 

FPFEvent  handles  events  in  the  FPF  dialog.  The  function  call  is  FPFEvent(dialog, 
itemNo).  Table  2.17-31  describes  the  parameters  used  and  functions  called  using  this 
function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Sevelopment:SIMNET  :libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

ApplyToBatteries 

See  Seciion  2.17.5.1.5. 

EndMission 

See  Section  2.17.8.5.2. 

HideWindow 

Standard  Window  Manager  function  for  Macintosh. 

ZoomMissionIcon 

See  Section  2.17.2.2.7. 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

BatterySelectionViable 

See  Section  2.17.5.1.9. 

rireVollev 

See  Section  2.17.5.1.2. 

See  Section  2.17.8.5.5. 

See  Section  2.17.8.5.4. 

Table  2.17-31:  FPFEvent  Information. 


2.17.1.4.7  ValidFPFTarget 

ValidP'PFI'arget  determines  whether  an  FPF  target  number  is  valid.  The  function  call  is 
ValidFPFTarget(dialog,  fp,  str).  Table  2.17-32  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DiaiogState 

Devetopment:SIMNET  :libmac; 
dialog. h 

Ip 

pointer  to  TypeInFieldDefn 

DevelopmentiSIMNET  ;libmac: 
dialog. h 

Standard  C  type. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

fpfTableField 

extern  ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmac: 
scroll. h 

register  FPFTargetHandle 


register  pointer  to  Mission 


DevelopmentiSIMNET  :MCC: 
FSE:  FSEMac.h 


Development;SIMNET;MCC: 

FSE:FSEMac.h 


Ret<jrn  Value 


0 


1 


Return  Values 


Type 


int 


int 


Meanin 


FPF  target  number  not  valid. 


FPFtarget  number  valid. 


Function 


LookupScrollTableEnt 


ShowCaution 


RedrawMissionIcon 


Calls 


Where  Described 


See  Section  2.22.1.24.1. 


See  Section  2.22.1.4.1. 


See  Section  2.17.2.2.5. 


Table  2.17-32:  ValidFPFTarget  Information. 
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2.17.1.4.8  LoadFPFBuffers 


LoadFPFBuffers  makes  field  definitions  for  FPF  mission  dialog  point  to  locations  of 
values  for  the  appropriate  mission.  The  function  call  is  LoadFPrauffers().  Table  2.17-33 
describes  the  intern^  variables  used  by  this  function. 


1  Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

m 

register  pointer  to  Mission 

Development:SIMNET;MCC: 

FSEFSEMac.h 

i 

register  short 

Standard  C  type. 

Called  By 


Function 

Where  Described 

ShowFPFMission 

See  Section  2.17.1.4.5. 

Table  2.17-33:  LoadFPFBuffers  Information. 


2.17.1.4.9  UpdateFPFDialog 


UpdateFPFDialog  updates  the  dialog  displaying  detailed  status  about  an  FPF  mission.  The 
function  call  is  UpdateFPFDialog().  Table  2.17-34  describes  the  internal  variables  used 
and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

m 

register  pointer  tc  lission 

Development  ;SIM  N  ET:M  C  C : 
FSE:FSEMac.h 

i 

int 

Standard  C  type. 

theltem 

Handle 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

box 

Rect 

DevelopmentiTHINK  C; 

Mac  #includes:MacTypes.h 

1  Calls  1 

Function 

Where  Described 

GelDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

SetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

InsetRect 

Standard  Quickdraw  function  for  Macintosh. 

Erase  Rect 

Standard  Quickdraw  function  for  Macintosh. 

InvalRecl 

Standard  Window  Manager  function  for  Macintosh. 

SellText 

Standard  Dialog  Manager  function  for  Macintosh. 

SetCTitle 

Standard  Control  Manager  function  for  Macintosh. 

|l|  1  1 II  1  II II  1  — 

See  Section  2.22.1.11.2. 

1  Called  By  1 

Function 

Where  Described 

ShowFPFMission 

See  Section  2.17.1.4.5. 

UpdateMissionDisplay 

See  Section  2.17.8.5.5. 

Table  2.17-34:  UpdateFPFDialog  Information 
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2.17.1.5  new.c 

Development:SIMNET  :MCC:FSE:  new.c 

new.c  implements  a  dialog  that  prompts  for  information  describing  a  new  fire  mission. 
Table  2. 17-35  describes  the  variables  used  in  new.c. 


1  Variables 

Variable 

Type 

Where  Typedef  Declared 

newMissionDialogDefn 

extern  DiabgDefn 

DevelopmentrSIMNET  :libmac: 
dialog. h 

newMissionLocationFields 

extern  array  of  TextFieldDefn 

Devetopment:SIMNET  ;libmac; 
dialoq.h 

newMissionDirectionFields 

extern  array  of 
NumberFieldDefn 

DevelopmentiSIMNET  ;libmac; 
dialoq.h 

newMissionDistance  Fields 

extern  array  of 
NumberFieldDefn 

DevelopmentiSIMNET  :libmac: 
dialoq.h 

observerBuffer 

array  of  observerLenath  char 

Standard  C  type. 

tqtBuffer 

char 

Standard  C  type. 

locnBuffer 

array  of  3 

T  arqetLocationBuff  er 

DevelopmentiSIMNET  iMCCi 
FSEiFSEMac.h 

directionBuffer 

array  of  2  int 

Standard  C  type. 

otDistanceBuffer 

int 

Standard  C  type. 

IrDistanceBuffer 

int 

Standard  C  type. 

adDistanceBuffer 

int 

Standard  C  type. 

IrButtonBuffer 

char 

Standard  C  type. 

adButtonBuffer 

char 

Standard  C  type. 

descriptionBuffer 

array  of  descriptionLength 
char 

Standard  C  type. 

newMissionCancelField 

PushButtonFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

newMissionObserverField 

TextFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

newMissionTglButtonsFields 

array  of  RBFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

newMissionLocationFields 

array  of  TextFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

newMissionDirectionFields 

array  of  NumberFieldDefn 

DevelopmentiSIMNETilibmaci 

dialoq.h 

newMissionDistance  Fields 

array  of  NumberFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

newMissionShiftBtnFields 

array  of  RBFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

newMissionDescriptionField 

TextFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

newMissionFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNETilibmaci 

dialoq.h 

newMissionDiabgDefn 

Dialog  Defn 

DevelopmentiSIMNET  ilibmaci 
dialoq.h 

Table  2.17-35;  new.c  Variable  Information. 
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2.17.1.5.1  ShowNewFireMission 

ShowNewFireMission  puts  up  a  dialog  to  take  target  information  for  a  new  fire  mission. 
The  function  call  is  ShowNewFireMission().  Table  2.17-36  describes  the  functions  called 
using  this  function. 


Function 


NewMission 


RedrawMissionIcon 


ShowDialo 


ShowWindow 


Calls 


Where  Described 


See  Section  2.17.8.5.1. 


See  Section  2.17.2.2.5. 


See  Section  2.22.1.11.1. 


Standard  Window  Manaaer  function  for  Macintosh. 


Called  B 


Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17*36:  ShowNewFireMission  Information. 

2.17.1.5.2  NewMissionEvent 

NewMissionEvent  handles  events  in  the  New  Mission  dialog.  The  routine  checks  for  the 
validity  of  the  data  and  performs  the  appropriate  action  associated  with  the  button  pressed. 
The  function  call  is  NewMissionEvent(dialog,  itemNo).  Table  2.17-37  describes  the 
parameters  used  and  functions  called  using  this  function. 
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_ _ Calls _ 

Function  [Where  Described 

ShowCaution _ See  Section  2.22.1 .4.1 , _ 

CheckMandatoryFields _ See  Section  2.22.1.13.1. _ 

ComputeAdjustment _ See  Section  2. 17.1.1 .3. _ 

PointToMapCoordinates _ See  Section  2.22.1  ■26.2. _ 

RedrawMissionIcon _ See  Section  2.17.2.2.5. _ 

ThrowDialoq _ See  Section  2.22.1 ,11 .3. _ 

ShowFireMission _ See  Section  2.17.1.2.4. _ 

EndMission _ See  Section  2.17.8.5.2. _ 

SellText  Standard  Dialog  Manager  function  for  Macintosh. 

Table  2.17-37:  NewMissionEvent  Information. 


2.17.1.6  target.c 

Development:  SEMNET  :MCC:FSE:target.c 

target-c  contains  a  routine  that  parses  a  string  specifying  a  target  location,  either  as  by  UTM 
coordinates  or  fire  target  number. 

2.17.1.6.1  ValidTgtLocation 

ValidTgtLocation  is  the  target  validation  routine  for  the  dialogs.  The  function  call  is 
ValidTgtLocation(dialog,  str).  Table  2.17-38  describes  the  parameters  used  and 
functions  called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

LookupFireTarqet 

See  Section  2.17.4.1.3. 

StrinqToMapCoordinates 

See  Section  2.22.1.26.1. 

ShowCaution 

See  Section  2.22.1.4.1. 

Table  2.17-38:  ValidTgtLocation  Information. 


2.17.2  Status  of  Artillery  Batteries 


2.17.2.1  battery.c 

Development:  SIMNET ;  MCC:FSE:battery  x 

batteryx  implements  a  dialog  displaying  the  status  of  an  artillery  battery.  Table  2.17-39 
describes  the  variables  used  in  battery.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

currentBattery 

pointer  to  Battery 

Development;SIMNET  ;MCC: 
FSE:FSEMac.h 

batteryDialog 

DialogRr 

Development:THINK  C: 

Mac  #includes.DialoqMqr.h 

batteryRect 

Rect 

Development.THINK  C: 

Mac  #includes:MacTvpes.h 

Table  2.17-39:  battery.c  Variable  Information. 


2.17.2.1.1  InstallDrawRoutine 

InstallDrawRoutine  installs  the  custom  draw  routines  used  by  the  battery  status  dialog.  The 
function  call  is  InstallDrawRoutine(itemNo,  fnc).  Table  2.17-40  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

itemNo 

int 

Standard  C  tvpe. 

iMO _ 

pointer  to  void  function 

Standard 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

i 

int 

Standard  C  type. 

theltem 

Handle 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

box 

Rect 

Development:THINK  C: 

Mac  #includes:MacTypes.h 

Calls 

Function 

Where  Described 

GetDItem 

Standard  Dialoq  Manager  function  for  Macintosh. 

SetDItem 

Standard  Dialoq  Manager  function  tor  Macintosh. 

1  1 
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1  Called  Bv  1 

1  Function 

Where  Described 

1  1  il»l  1  Ihl 

See  Section  2.17.2.1.2. 

Table  2.17-40:  InstailDrawRoutine  Information. 
2.17.2.1.2  SetUpBattery 

SetUpBattery  initializes  a  dialog  for  displaying  the  battery  status.  The  function  call  is 
SetUpBatteryO.  Table  2.17-41  describes  the  functions  called  using  this  function. 


I 


I  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

i 

reaister  short 

Standard  C  type. 

itemNos 

array  of  char 

Standard  C  type. 

I  Calls  I 

Function 

Where  Described 

GetNewDialoa 

Standard  Dialoq  Manaaer  function  for  Macintosh. 

Outline  Item 

See  Section  2.22.1.27.2. 

InstailDrawRoutine 

See  Section  2.17.2.1.1. 

SetWRefCon 

Standard  Window  Manaaer  function  for  Macintosh. 

I  Called  Bv  I 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

Table  2.17-41:  SetUpBattery  Information. 

2.17.2.1.3  ShowBattery 

ShowBattery  shows  the  dialog  displaying  the  status  of  a  gun  battery,  b.  The  function  call 
is  ShowBattery(b).  Table  2.17-42  describes  the  parameters  used  and  functions. called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

b 

register  pointer  to  Battery 

Development:SIMNET  :MCC: 
FSEiFSEMac.h 

Caiis 

Function 

Where  Described 

Select  Window 

Standard  Window  Manager  function  for  Macintosh. 

ZoomBatterylcon 

See  Section  2.17.2.2.8. 

ShowWindow 

Standard  Window  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

StatusEventHandler 

See  Section  2.17.2.2.4. 

Table  2.17-42:  ShowBattery  Information. 
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2.17.2.1.4  BatteryEventHandler 

BatteryEventHandler  handles  an  event  in  the  battery  status  dialog.  The  function  call  is 
BatteryEventHandler(window,  theEvent).  Table  2.17-43  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

window 

WindowPtr 

Development:THINK  C: 

Mac  #includes:WindowMgr.h 

theEvent 

pointer  to  EventRecord 

Development:THINK  C: 

Mac  #inciudes;EventMgr.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

dp 

DialogRr 

Development:THINK  C: 

Mac  #includes;DialogMgr.h 

i 

int 

Standard  C  type. 

Calls  1 

Function 

Where  Described 

DialoqSelect 

Standard  Dialog  Manager  function  for  Macintosh. 

Hide  Window 

Standard  Window  Manager  function  for  Macintosh. 

ZoomBatterylcon 

See  Section  2.17.2.2.8. 

Table  2.17-43:  BatteryEventHandler  Information. 

2.17.2.1.5  DrawBatteryText 

DrawBatteiyText  draws  a  text  field  in  the  battery  dialog.  The  function  call  is 
DrawBatteryText(theWindow,  itemNo).  Table  2.17-44  describes  the  parameters  used  and 
functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

the  Window 

WindowPtr 

DevelopmentiTHINK  C: 

Mac  #includes;WindowMgr.h 

int 


Standard  C  type. 


itemNo 
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Internal  Variables 


Variable 


theltem 


int 


Handle 


register  pointer  to  Battery 


register  pointer  to  stmct  Half 


pointer  to  Mission 


inter  to  char 


array  of  100  char 


Where  TvDedef  Declared 


Standard  C  t 


Development:THINK  C: 
Mac  #includes:MacTYpes.h 


Development;THINK  C:  . 
Mac  #includes:MacTvpes.h 


DevelopmentiSIMNET  :MCC: 
FSE:FSEMac.h 


Oevelopment:SIMNET  :MCC; 
FSE:FSEMac.h 


DevelopmentiSIMNET  ;MCC; 
FSE:FSEMac.h 


Standard  C  t 


Standard  C  tvoe. 


Function 


GetDItem 


SetPort 


Text  Box 


Calls 


Where  Described 


Standard  Dialoo  Manager  function  for  Macintosh. 


Macro  defined  in  FSEMac.h.  See  Section  2.17.7.2. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  TextEdit  function  for  Macintosh. 


Table  2.17-44:  DrawBatteryText  Information. 

2.17.2.1.6  DrawBatteryRect 

DrawBatteryRect  draws  a  rectangle  in  the  battery  dialog.  The  function  call  is 
DrawBatteryRect(theWindow,  itemNo).  Table  2.17-45  describes  the  parameters  used  and 
functions  cdled  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

the  Window 

WindowRr 

DevelopmentiTHINK  C: 

Mac  #includes:WindowMgr.h 

itemNo 

int 

Standard  C  type. 

Variable 


theltem 


Internal  Variables 


e 


int 


Handle 


Where  Tvpedef  Declared 


Standard  C  t 


Development:THINK  C; 
Mac  #includes;MacTypes.h 


Deyelopment:THINK  C: 
Mac  #includes;MacTyDes.h 


Calls 


Function  Where  Described 


GetDItem  Standard  Dialog  Manager  function  for  Macintosh. 


SetPort  Standard  Quickdraw  function  for  Macintosh. 


PenNormal  Standard  Quickdraw  function  for  Macintosh. 


FrameRect  Standard  Quickdraw  function  for  Macintosh. 


Table  2.17-45:  DrawBatteryRect  Information. 


501 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.17.2.1.7  UpdateBatteryDisplay 

UpdateBatteryDispIay  updates  the  screen  for  a  battery,  specified  by  battery  and  half,  whose 
status  may  have  changed.  The  function  call  is  UpdateBatteryDisplay(battery,  half).  Table 
2.17-46  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


batte 


half 


Variable 


theltem 


lEin 


Internal  Variables 


e 


int 


Handle 


Where  Tvoedef  Declared 


Standard  C  type. 


Standard  C  t 


Where  Tvoedef  Declared 


Standard  C  type. 


DevelopmentiTHINK  C: 
Mac  #includes;MacTypes.h 


DevelopmentTHlNK  C; 
Mac  #jncludes;MacTypes.h 


Function 


RedrawBatterylcon 


SetPort 


GetDItem 


InvalRect 


Calls 


Where  Described 


See  Section  2.17.2.2.6. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Oialoq  Manaoer  function  for  Macintosh. 


Standard  Window  Manaoer  function  for  Macintosh. 


Function 


LocalUnitDispatched 


LocalUnitArrived 


RemoteUnitDispatched 


RemoteUnitArrived 


UpdateUnitLocation 


CheckTimers 


StartMissionBatte 


EndMissionBatte 


ProcessReouest 


Called  B 


Where  Described 


See  Section  2.17.3.2.1. 


See  Section  2.17.3.2.2. 


See  Section  2.17.3.2.3. 


See  Section  2.17.3.2.4. 


See  Section  2.17.3.2.6. 


See  Section  2.17.5.1.1. 


See  Section  2.17.5.1.6. 


See  Section  2.17.5.1.7. 


See  Section  2.17.8.3.6. 


Table  2.17-46;  UpdateBatteryDisplay  Information. 

2.17.2.1.8  UpdateAmmoDisplay 

UpdateAmmoDi splay  updates  the  display  of  a  battery’s  ammo  supply,  if  visible.  The 
function  call  is  U^ateAmmoDisplay(b).  Table  2.17-47  describes  the  parameters  used  and 
functions  called  using  this  function. 
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1  internal  Variables  1 

Variable 

Where  Tvnedef  Declared 

i 

int 

Standard  C  tvoe. 

theltem 

Handle 

Development:THINK  C: 

Mac  #includes:MacTyDes.h 

r 

Rect 

DevelopmentrTHINK  C: 

Mac  #includes;MacTyDes.h 

1  Calls  1 

Function 

Where  Described 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

GetDItem 

Standard  Dialoq  Manaaer  function  for  Macintosh. 

InvalRect 

Standard  Window  Manaqer  function  for  Macintosh. 

1  Called  Bv  1 

Function 

Where  Described 

FireVolley 

See  Section  2.17.5.1.2. 

ProcessRequest 

See  Section  2.17.8.3.6. 

Table  2.17-47:  UpdateAmmoDisplay  Information. 

2.17.2.2  status. c 

Development:SIMNET:MCC:FSE:status.c 

statusx  implements  a  window  displaying  the  status  of  all  artillery  batteries  and  active  fire 
missions.  Table  2.17-48  describes  the  variables  used  in  status.c. 


1  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

statusWindow 

WindowRr 

DeyelopmentTHINK  C: 

Mac  tincludesiWindowMqr.h 

headinqBaseline 

short 

Standard  C  type. 

columnCentre 

array  of  numberOfColumns 
short 

Standard  C  type. 

textHeiqht 

short 

Standard  C  type. 

rowBase 

array  of  numberOfRows  struct 
RowBase 

Development;SiMNET  :MCC: 
FSE:status.c 

missionPix 

array  of  maxNumberMissions 
struct  MissionPix 

DevelopmentiSIMNET  :MCC: 
FSE:status.c 

batteryPix 

array  of  maxNumberBatteries 
struct  BatteryPix 

DevelopmentiSIMNET  iMCC: 
FSEistatus.c 

missionicons 

array  of  3  Handle 

DevelopmentiTHINK  C: 

Mac  #includes:MacTvpes.h 

Table  2.17-48:  status.c  Variable  Information. 
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2.17.2.2.1  SetUpStatusWindow 

SetUpStatusWindow  creates  and  displays  the  status  window.  Each  fire  unit  status  icon, 
each  row  of  mission  status  icons,  and  each  mission  status  is  located.  The  icons  are  loaded 
from  the  resource  files.  The  function  call  is  SetUpStatusWindowQ.  Table  2.17-49 
describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

i 

register  short 

Standard  C  type. 

m 

pointer  to  struct  MissionPix 

Development:SIMNET  :MCC: 
FSE:status.c 

b 

pointer  to  street  BatteryPix 

Development;SIMNET  ;MCC; 
FSErstatus.c 

r 

pointer  to  Rect 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

finfo 

Font  Info 

DevelopmentiTHINK  C: 

Mac  #includes;Quickdraw.h 

columnWidth 

short 

Standard  C  type. 

columnHalf  Width 

short 

Standard  C  type. 

centre 

short 

Standard  C  type. 

leflEdqe 

short 

Standard  C  type. 

riphtEdae 

short 

Standard  C  type. 

iconTop 

short 

Standard  C  type. 

iconBottom 

short 

Standard  C  type. 

short 

Standard  C  type. 

name  Bottom 

short 

Standard  C  type. 

statusTop 

short 

Standard  C  type. 

statusBottom 

short 

Standard  C  type. 

targetTop 

short 

Standard  C  type. 

tarqetBottom 

short 

Standard  C  type. 

rowHeiqht 

short 

Standard  C  type. 

iconResourcelD 

array  of  int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetNewWindow 

Standard  Window  Manager  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

SetWRefCon 

Standard  Window  Manager  function  for  Macintosh. 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

Text  Size 

Standard  Quickdraw  function  for  Macintosh. 

GetFontInfo 

Standard  Quickdraw  function  for  Macintosh. 

SetRect 

Standard  Quickdraw  function  for  Macintosh. 

LocalToGlobal 

Standard  Quickdraw  function  for  Macintosh. 

Geticon 

Standard  Toolbox  Utility  function  for  Macintosh. 

Called  By  1 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

Table  2.17-49:  SetUpStatusWindow  Information. 


504 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.17.2.2.2  ShowStatusWindow 

ShowStatusWindow  makes  the  status  window  visible.  The  function  call  is 
ShowStatusWindow().  Table  2.17-50  describes  the  functions  called  using  this  function. 


Calls 

Function 

Where  Described 

ShowWindow 

Standard  Window  Manaaer  fundion  for  Macintosh. 

SeledWindow 

Standard  Window  Manaqer  fundion  for  Macintosh. 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

MenuCommand 

See  Sedion  2.17.8.4.5. 

Table  2.17-50:  ShowStatusWindow  Information. 

2.17.2.2.3  DrawStatusWindow 

DrawStatusWindow  draws  the  contents  of  the  status  window.  Headings,  battery  status, 
and  mission  status  are  drawn.  The  function  call  is  DrawStatusWindow().  Table  2.17-51 
describes  the  internal  variables  used  and  functions  called  using  this  function. 


Variable 


Internal  Variables 


e 


reqister  short 


register  pointer  to  struct 
MissionPix 


register  pointer  to  Mission 


pointer  to  struct  BatteryPix 


pointer  to  Red 


short 


inter  to  char 


array  of  1 0  char 


inter  to  array  of  char 


Where  Tvpedef  Declared 


Standard  C  type. 


Deyelopment:SIMNET  :MCC: 
FSE:status.c 


Development:SIMNET:MCC: 

FSE:FSEMac.h 


Development:SIMNET  :MCC: 
FSE:status.c 


Development:THINK  C: 
Mac  #includes:MacTyDes.h 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Function 


SetPort 


Text  Size 


TextFont 


MoveTo 


DrawStrin 


PenSize 


Line 


Erase  Rect 


Ploticon 


TextBox 


Calls 


Where  Described 


Standard  Quickdraw  fundion  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  fundion  for  Macintosh. 


Standard  Toolbox  Utility  function  for  Macintosh. 


Standard  TextEdit  function  for  Macintosh. 
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1  Called  By  I 

Function 

Where  Described 

StatusEventHandler 

See  Section  2.17.2.2.4. 

Table  2.17-51:  DrawStatusWindow  Information. 


2.17.2.2.4  StatusEventHandler 


StatusEventHandler  handles  an  event  in  the  status  window.  The  function  call  is 
StatusEventHandler(window,  theEvent).  Table  2.17-52  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

window 

WindowRr 

DevelopmentTHINK  C: 

Mac  #includes:WindowMgr.h 

theEvent 

pointer  to  EventRecord 

DevelopmentTHINK  C: 

Mac  #includes;EventMgr.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

savePort 

GrafRr 

DevelopmentiTHINK  C: 

Mac  #includes;Quickdraw.h 

i 

reqister  short 

Standard  C  tvpe. 

Pt 

Point 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

1  Calls  1 

Function 

Where  Described 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

GlobalToLocal 

Standard  Quickdraw  function  for  Macintosh. 

RInRect 

Standard  Quickdraw  function  for  Macintosh. 

OpenMission 

See  Section  2.17.8.5.3. 

ShowBattery 

See  Section  2.17.2.1.3. 

BeainUpdate 

Standard  Window  Manaaer  function  for  Macintosh. 

DrawStatusWindow 

See  Section  2.17.2.2.3. 

EndUpdate 

Standard  Window  Manager  function  for  Macintosh. 

Table  2.17-52:  StatusEventHandler  Information. 


2.17.2.2.5  RedrawMissionIcon 

RedrawMissionIcon  forces  an  update  of  the  mission  status  in  the  status  window.  The 
function  call  is  RedrawMissionlcon(m).  Table  2.17-53  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

m 

pointer  to  Mission 

Development;SlMNET;MCC; 

FSE.FSEMac.h 

BBN  Systems  and  Technologies _ _ _ MCC  CSCI 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

savePort 

GrafRr 

DevelopmentTHINK  C: 

Mac  #includes;Quickdraw.h 

1  Calls  1 

Function 

Where  Described 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

InvalRect 

Standard  Window  Manaqer  function  for  Macintosh. 

1  Called  By  1 

Function 

Where  Described 

ShowNewFPFMission 

See  Section  2.17.1.4.3. 

ValidFPFTarqet 

See  Section  2.17.1.4.7. 

ShowNewFireMission 

See  Section  2.17.1.5.1. 

NewMissionEvent 

See  Section  2.17.1.5.2. 

UpdateObserver 

See  Section  2.17.8.5.7. 

UpdateMissionState 

See  Section  2.17.8.5.6. 

UpdateMissionDisplay 

See  Section  2.17.8.5.5. 

EndMission 

See  Section  2.17.8.5.2. 

UnhookFireTarqet 

See  Section  2.17.4.1.15. 

Table  2.17-53:  RedrawMissionIcon  Information. 


2.17.2.2.6  RedrawBatterylcon 

RedrawBatterylcon  forces  an  update  of  the  battery  status  in  the  status  window.  The 
function  call  is  RedrawBa:teryIcon(b,  half).  Table  2.17-54  describes  the  parameters  used 
and  functions  called  using  this  function. 


Parameters 


Where  Typedef  Declared 

Standard  C  type. _ 

Standard  C  type. _ 


Variable _ Type _ Where  Typedef  Declared 

savePort  GratPtr  DevelopmentiTHINK  C; 


Mac  #includes:Quickdraw.h 


Calls 

Function 

Where  Described 

GetPort 

Standard  Quickdraw  function  for  Macintosh. 

SetPort 

Standard  Quickdraw  function  for  Macintosh. 

InvalRect 

Standard  Window  Manaqer  function  for  Macintosh. 

Table  2.17-54:  RedrawBatterylcon  Information. 
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2.17.2.2.7  ZoomMissionIcon 

ZoomMissionIcon  zooms  to  or  from  a  mission  icon.  The  function  call  is 
ZoomMissionIcon(m,  bigRect,  zoomUp).  Table  2.17-55  describes  the  parameters  used 
and  function  called  using  this  function. 


Parameter 


m 


bigRect 


zoomU 


Parameters 


e 


pointer  to  Mission 


pointer  to  Red 


Where  Tvoedef  Declared 


Development  :SIMNET  :MCC: 
FSE:FSEMac.h 


DevelopmentiTHINK  C; 
Mac  #includes:MacTvpes.h 


Standard  C  type. 


Calls 

Function 

Where  Described 

ZoomRect 

See  Section  2.22.1.47.2. 

Called  B 


Function 

Where  Described 

OpenFireMission 

See  Section  2.17.1.2.3. 

FireEvent 

See  Section  2.17.1.2.5. 

EndFireMission 

See  Section  2.17.1.2.10. 

OpenFPFMission 

See  Section  2.17.1.4.4. 

FPFEvent 

See  Section  2.17.1.4.6. 

Ti-ible  2.17-55:  ZoomMissionIcon  Information. 

2.17.2.2.8  ZoomBatterylcon 

ZoomBatterylcon  zooms  to  or  from  a  batter}'  icon.  The  function  call  is 
ZoomBatteryIcon(b,  bigRect,  zoomUp).  Table  2.17-56  describes  the  parameters  used  and 
functions  called  using  this  function. 


Parameters 


Parameter 


bigRect 


zoomU 


int 


pointer  to  Red 


Where  lypedef  Declared 


Standard  C  type. 


Devetopment  THINK  C: 
Mac  #includes:MacTvpes.h 


Standard  C  type. 


Function 


ZoomRect 


Calls 


Where  Described 


See  Section  2,22.1  47,2 


Function 


BatteryEventHandler 


Called  B 


Where  Described 


See  Section  2.17.2.1.3 


See  Section  2.17.2  1 .4 


Tabic  2.17-56:  ZoomBatterylcon  Information. 
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2.17.3  Displacement  of  Artillery  Batteries 


2.17.3.1  displace. c 

Development:SIMNET:MCC:FSE:displace.c 

displaces  implements  dialogs  controlling  mortar  displacement.  Table  2.17-57  describes 
the  variables  used  in  displace.c. 


1  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

displacedialogDefn 

extern  DialogDefn 

DevelopmentiSIMNET  :libmac: 
dialog. h 

abort  Dialog  Defn 

extern  DialogDefn 

DevetopmentiSIMNET  :libmac: 
dialog,  h 

displace  Displayed 

char 

Standard  C  type. 

displaceBattery 

int 

Standard  C  type. 

displaceHalt 

int 

Standard  C  type. 

destLocnBuffer 

MapCoordinates 

DevetopntsntiSIMNET  ilibmac: 
map.h 

destAzimuthBuffer 

int 

Standard  C  type. 

spTimeBuffer 

DateTimeGroup 

DevelopmentiSIMNET  :libmac: 
dtg.h 

rpTimeBuffer 

DateTimeGroup 

DevelopmentiSIMNET  ilibmac: 
dtg.h 

displaceCancelField 

PushButtonFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

displace  DestLocnField 

CoordinatesFieldDefn 

DevelopmentiSlMNETilibmaci 
dialog. h 

displace  DestAzimuthField 

NumberFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

displaceSPTime  Field 

DTGFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog,  h 

displaceFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

displace  DialogDefn 

DialogDefn 

DevelopmentiSiMNET  ilibmac: 
dialog. h 

abortFieldLisf 

pointer  to  array  of  FieldDefn 

DevelopmentiSiMNET  ilibmac: 
dialog. h 

abort  Dialog  Defn 

DialogDefn 

DevelopmentiSiMNET  ilibmac: 
dialog. h 

Table  2.17-57:  displace.c  Variable  Information. 

2.17.3.1.1  ShowDisplace 

ShowDisplace  puts  up  the  dialog  which  allows  entry  or  cancelling  of  a  mortar  displacement 
order.  The  function  call  is  ShowDisplace(battery,  half)-  Table  2.17-58  describes  the 
parameters  used  and  functions  called  using  this  function. 
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Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

hp 

register  pointer  to  struct  Half 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

1  Calls  1 

Function 

Where  Described 

ShowDialOQ 

See  Section  2.22.1.11.1. 

ShowWindow 

Standard  Window  Manager  function  for  Macintosh. 

1  Called  Bv  1 

1  Function 

Where  Described 

See  Section  2.17.8.3.3. 

1  MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17-58:  ShowDisplace  Information. 

2.17.3.1.2  ThrowDisplace 

ThrowDisplace  discards  any  mortar  displacement  dialog  which  is  visible.  The  function  call 
is  ThrowDisplace(battery,  half).  Table  2.17-59  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared  1 

battery 

int 

half 

int 

Standard  C  type.  I 

1  Calls  1 

Function 

Where  Described 

Throw  Dialog 

See  Section  2.22.1.11.3. 

1  Called  By  I 

Function 

Where  Described 

AbortEvent 

See  Section  2.17.3.1.8. 

DisplaceEvent 

See  Section  2.17.3.1.5. 

LocalUnitDispatched 

See  Section  2.17.3.2.1. 

LocalUnitArrived 

See  Section  2.17.3.2.2. 

RemoteUnitDispatched 

See  Section  2.17.3.2.3. 

RemoteUnitArrived 

See  Section  2.17.3.2.4. 

ProcessReguest 

See  Section  2.17.8.3.6. 

Table  2.17-59:  ThrowDisplace  Information. 
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2.17.3.1.3 


DisplaceFetch 


DisplaceFetch  reads  the  current  data  structures  for  the  Schedule  Displacement  dialog  into 
the  dialog  for  display  to  the  user.  The  function  call  is  DisplaceFetch(dialog).  Table  2. 17- 
60  describes  the  parameters  used  and  functions  called  using  this  fiinction. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  OialogState 

Development'.SIMNET  :libmac: 
dialog.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

hp 

register  pointer  to  struct  Half 

Development:SIMNET  :MCC: 
FSErFSEMac.h 

str 

array  of  20  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

UpdateReleasePoint 

See  Section  2.17.3.1.4. 

1  Called  By  1 

Function 

Where  Described 

Undo  Displace 

See  Section  2.17.3.1.6. 

Table  2.17-60:  DisplaceFetch  Information. 


2.17.3.1.4  UpdateReleasePoint 

UpxiateReleasePoint  updates  the  computed  release  point.  The  function  call  is 
UjxlateReleasePointO.  Table  2.17-61  describes  the  internal  variables  used  and  functions 
called  using  this  function. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

str 

array  of  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

DTGEIapsed 

See  Section  2.22.1.15.3. 

DistBetween2Pts 

See  Section  2.22.1.23.2. 

DTGToString 

See  Section  2.22.1.15.1. 

SetText 

See  Section  2.22.1.11.8. 

1  Called  By  I 

Function 

Where  Described 

DisplaceEvent 

See  Section  2.17.3.1.5. 

DisplaceFetch 

See  Section  2.17.3.1.3. 

Table  2.17-61: 


UpdateReleasePoint  Information. 
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2.17.3.1.5  DispUceEvent 

DisplaceEvent  handles  events  in  the  Displace  dialog.  The  function  call  is 
DisplaceEvent(dialog,  itemNo).  Table  2.17-62  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

Development  :SIMNET  ;libmac; 
dialOQ.h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

hp 

register  pointer  to  struct  Half 

Development:SIMNET  :MCC; 
FSE:FSEMac.h 

Calls 

Function 

Where  Described 

UpdateReleasePoint 

SeeSection  2.17.3.1.4. 

CheckMandatorvFields 

See  Section  2.22.1.13.1. 

ThrowDisDiace 

See  Section  2.17.3.1.2. 

Table  2.17*62:  DisplaceEvent  Information. 

2.17.3.1.6  UndoDisplace 

UndoDisplace  undoes  any  changes  in  the  displace  dialog.  The  function  call  is 
UndoDisplace().  Table  2.17-63  describes  the  parameters  used  and  functions  called  using 
this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

hp 

register  pointer  to  struct  Half 

Development:SIMNET  :MCC; 
FSEiFSEMac.h 

Calls 

Function 

Where  Described 

Displace  Fetch 

See  Section  2.17.3.1.3. 

UpdateDialoq 

See  Section  2.22.1.11.2. 

Called  By 

Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17*63:  UndoDisplace  Information. 
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2.17.3.1.7  AbortFetch 

AbortFetch  reads  current  values  into  the  Abort  Displacement  dialog.  The  function  call  is 
AbortFetch(dialog).  Table  2.17-64  describes  the  parametf'rs  used  and  functions  called 
using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  OialogState 

Development:SIMNET  :libmac; 
dialog,  h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

hp 

register  pointer  to  struct  Half 

DevelopmentiSIMNET  :MCC: 
FSE:FSEMac.h 

sir 

array  of  20  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

DTGToStrina 

See  Section  2.22.1.15.1. 

RedrawUnitLocation 

See  Section  2.17.3.1.9. 

Table  2.17-64  :  AbortFetch  Information. 

2.17.3.1.8  AbortEvent 

AbortEvent  handles  events  in  the  Abort  Displacement  dialog.  If  the  Do  button  is  pressed, 
the  immediate  arrival  of  the  fire  unit  is  forced.  If  the  Dont  button  is  pressed,  the  dialog  is 
taken  down.  The  function  call  is  AbortEvent(dialog,  itemNo).  Table  2.17-65  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog,  h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

hp 

register  pointer  to  struct  Half 

Development:SIMNET  ;MCC: 
FSE:FSEMac.h 

now 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

ThrowDisplace 

See  Section  2.17.3.1.2. 

Table  2.17-65:  AbortEvent  Information. 
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2.17.3.1.9  RedrawUnitLocation 


RedrawUnitLocation  redraws  the  location  of  a  fire  unit,  specified  by  battery  and  half,  if  it  is 
currently  displayed  in  a  displacement  dialog.  The  function  call  is 
RedrawUnitLocation(battery,  half).  Table  2.17-66  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

battery 

int 

Standard  C  type. 

half 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

hp 

register  pointer  to  struct  Half 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

Calls 

Function 

Where  Described 

SetText 

See  Section  2.22.1.11.8. 

Called  By 

Function 

Where  Described 

AbortFetch 

See  Section  2.17.3.1.7. 

UpdateUnitLocation 

See  Section  2.17.3.2.6. 

Table  2.17-66:  RedrawUnitLocation  Information. 


2.17.3.2  move.c 

Development:  SIMNET:MCC:FSE:move.c 

move.c  contains  routines  that  model  the  displacement  of  artillery  batteries. 

2.17.3.2.1  LocalUnitDispatched 

LocalUnitDispatched  is  called  when  a  fire  unit,  specified  by  battery  and  half,  is  leaving  on 
displacement  due  to  an  order  entered  at  this  console.  The  function  call  is 
LocalUnitDispatched(battery,  half).  Table  2.17-67  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

battery 

int 

Standard  C  type. 

halt 

int 

Standard  C  type. 

BBN  Systems  and  Technologies _ MCC  CSCI 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

hp 

register  pointer  to  struct  Half 

DevelopmentiSIMNET  :MCC; 
FSEiFSEMac.h 

now 

unsigned  Iona 

Standard  C  type. 

delay 

unsigned  Iona 

Standard  C  type. 

ab 

ABRecHandle 

DevelopmentiTHINK  C: 

Mac  #includes:Appletalk.h 

req 

pointer  to 

FSEDispatchRequest 

DevelopmentiSIMNET  iMCCi 
FSEiFSE.h 

errCode 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

DIG  Elapsed 

See  Section  2.22.1.15.3. 

ThrowDisplace 

See  Section  2.17.3.1.2. 

UpdateBattery  Display 

See  Section  2.17.2.1.7. 

UpdateBatterySelection 

See  Section  2.17.5.2.2. 

NewRr 

Standard  Memory  Manager  function  for  Macintosh. 

NewHandle 

Standard  Memory  Manager  function  for  Macintosh. 

SetUpATPRequest 

See  Section  2.22.1.3.2. 

ATPRequest 

Standard  Appletalk  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

CheckTimers 

See  Section  2.17.5.1.1. 

Table  2.17*67:  LocalUnitDispatched  Information. 


2.17.3.2.2  LocalUnitArrived 

LocalUnitArrived  is  called  when  a  fire  unit,  specifed  by  battery  and  half,  has  arrived 
following  a  displacement  order  entered  at  this  console.  The  fire  unit  begins  setting  up  and 
the  host  is  notified.  The  function  call  is  LocalUnitArrived(battery,  half).  Table  2.17-68 
describes  the  parameters  used  and  functions  called  using  this  function. 


Parameter 


batte 


half 


Parameters 


Where  Tvoedef  Declared 


Standard  C  type. 


Standard  C  type. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

hp 

register  pointer  to  struct  Half 

DevelopmentiSIMNET  iMCCi 
FSEiFSEMac.h 

errCode 


pointer  to  FSEArriveRequest 


Standard  C  t 


Development:THINK  C: 
Mac  #jncludes;Appletalk.h 


DevelopmentiSIMNET  :MCC: 
FSE:FSE.h 


Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

GetDateTime 

Standard  Operatinq  System  Utility  function  for  Macintosh. 

ThrowDisDiace 

See  Section  2.17.3.1.2. 

See  Section  2.17.2.1.7. 

NewPtr 

Standard  Memory  Manaqer  function  for  Macintosh. 

NewHandle 

Standard  Mermry  Manaqer  function  for  Macintosh. 

SetUpATPRequest 

See  Section  2.22.1.3.2. 

ATPRequest 

Standard  Appletalk  Manaqer  function  for  Macintosh. 

1  Called  Bv  1 

Function 

Where  Described 

CheckTimers 

See  Section  2.17.5.1.1. 

Table  2.17-68:  LocalUnitArrived  Information. 

2.17.3.2.3  RemoteUnitDispatched 

RemoteUnitDispatched  is  called  when  a  fire  unit,  specified  by  battery  and  half,  is  leaving 
on  displacement  due  to  an  order  entered  at  another  console.  The  battery  is  withdrawn  and 
the  screen  is  updated.  The  function  call  is  RemoteUnitDispatched(battery,  half).  Table 
2.17-69  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

battery 

int 

Standard  C  type. 

half 

inf 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

hp 

register  pointer  to  struct  Half 

Deyelopment;SIMNET  :MCC: 
FSE:FSEMac.h 

now 

Standard  C  type. 

delay 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

WithdrawBattery 

See  Section  2.17.5.2.3. 

ThrowDisplace 

See  Section  2.17.3.1.2. 

UpdateBattery  Display 

See  Section  2.17.2.1.7. 

UpdateBatterySelection 

See  Section  2.17.5.2.2. 

1  Called  By  I 

Function 

Where  Described 

ProcessRequest 

See  Section  2.17.8.3.6. 

Table  2.17-69:  RemoteUnitDispatcbed  Information. 
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2.17.3.2.4 


RemoteUnit  Arrived 


RemoteUnitAirived  is  called  when  a  fire  unit  has  arrived  following  a  displacement  order 
entered  at  another  console.  The  new  location  and  azimuth  of  the  fire  unit  is  noted,  the  fire 
unit  begins  setting  up,  and  the  screen  is  updated.  The  function  call  is 
RemoteUnitArrived(battery,  half,  location,  azimuth).  Table  2.17-70  describes  the 
parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

battery 

int 

Standard  C  type. 

half 

int 

Standard  C  type. 

location 

pointer  to  LongR 

DevelopmentiSIMNET  rlibmac; 
lonopt.h 

azimuth 

short 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

hp 

register  pointer  to  struct  Half 

DevelopmentiSIMNET  iMCC: 
FSEiFSEMac.h 

now 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

PointToMaoCoordinates 

See  Section  2.22.1.26.2. 

GetDateTime 

Standard  Operatino  System  Utility  function  for  Macintosh. 

ThrowDisDiace 

See  Section  2.17.3.1.2. 

UpdateBatteryDisplav 

See  Section  2.17.2.1.7. 

1  Called  By  I 

Function 

Where  Described 

ProcessRequest 

See  Section  2.17.8.3.6. 

Table  2.17-70:  RemoteUnitAi  rived  Information. 

2.17.3.2.5  InterpolatePoints 

InterpolatePoints  locates  a  point  some  fraction  of  the  way  between  two  other  points.  The 
function  call  is  InterpolatePoints(ptl,  pt2,  num,  denom,  ptint).  Table  2.17-71  describes 
the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

pti 

pointer  to  LongR 

DevelopmentiSIMNET  ilibmaci 
lonqpt.h 

pt2 

pointer  to  LongR 

DevelopmentiSIMNET  ilibmac 
lonqpt.h 

ptint 

pointer  to  LongR 

DevelopmentiSIMNET  ilibmaci 
lonqpt.h 

num 

lonq 

Standard  C  type. 

denom 

lonq 

Standard  C  type. 

1  1 
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1  Internal  Variables  I 

Variable 

Where  Tvbedef  Declared 

tract 

float 

Standard  C  type. 

1  Called  By  1 

Function 

Where  Described 

UpdateUnitLocation 

See  Section  2.17.3.2.6. 

Table  2.17-71:  InterpolatePoints  Information. 

2.17.3.2.6  UpdateUnitLocation 

UpdateUnitLocation  interpolates  and  redraws  a  fire  unit’s  location,  battery  and  half 
describe  the  fire  unit.  The  function  call  is  UpdateUnitLxx:ation(battery,  half).  Table  2.17- 
72  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

battery 

int 

Standard  C  type. 

half 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

hp 

register  pointer  to  struct  Half 

DevelopmentiSIMNET  :MCC: 
FSErFSEMac.h 

now 

unsigned  long 

Standard  C  type. 

pt 

LongPt 

Developmenf.SIMNET  ilibmac. 
longpt.h 

1  Calls  1 

Function 

Where  Described 

GetDateTime 

Standard  OperatingSystem  Utility  function  for  Macintosh. 

InterpolatePoints 

See  Section  2.17.3.2.5. 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

RedrawUnitLocation 

See  Section  2.17.3.1.9. 

UpdateBatteryDisplay 

See  Section  2.17.2.1.7. 

1  Called  By  1 

Function 

Where  Described 

CheckTimers 

See  Section  2.17.5.1.1. 

Table  2.17-72:  UpdateUnitLocation  Information. 


518 


BBN  Systems  and  Technologies 


MCC  CSCI 


2.17.4  Dialog  Lists  of  Scheduled  Missions 


2.17.4.1  firetarget.c 

Development:SIMNET  :MCC:FSE:firetarget.c 

firetarget.c  implements  a  dialog  containing  a  scrolling  table  of  indirect  fire  targets.  Table 
2.17-73  describes  the  variables  used  in  firetargetc. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

fireTableDialogDefn 

extern  DialogDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

fireEntryDialogOefn 

externDialogDefn 

DevelopmentiSIMNET  ;libmac; 
dialog. h 

fireTableFieW 

extern  ScrollTableFieldDefn 

Development:SIMNET  :libmac; 
scroll.h 

fireTableColumns 

extern  array  of 
ScrollTableColumnDefn 

Development:SIMNET  :libmac: 
scroll.h 

firelableDialog 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
dialog. h 

currentFireTarget 

FireTargetHandle 

DevelopmentiSIMNET  :MCC: 
FSE:FSEMac.h 

fireTargetBuffer 

FireTargetDescriptor 

Development;SIMNET  :MCC: 
FSEiFSEMac.h 

lireTqtNumberBuffer 

int 

Standard  C  type. 

fireTableColumns 

array  of 

ScrollT  ableColumnDef  n 

Development:SIMNET  ;libmac: 
scroll.h 

firelableFleld 

ScrollTableFieldDefn 

Development:SIMNET  ;libmac; 
scroll.h 

fireTableFieldList 

pointer  to  array  of  FieldDefn 

Development;SIMNET  :libmac; 
dialog. h 

fireT  ableDialogDef  n 

DialogDefn 

Devetopment:SIMNET  :libmac: 
dialog. h 

fireEntryDeleteField 

PushButtonFieldDefn 

DevelopmentiSIMNET  :libmac: 
dialog. h 

fireEntryNumberField 

NumberFieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog. h 

fireEntryLocationField 

CoordinatesFieldDefn 

DevelopmentiSIMNET  ;libmac: 
dialog. h 

fiieEntryTextFleld 

array  of  Text  FieldDefn 

Development:SIMNET  :libmac; 
dialog,  h 

lireEnlryFleldList 

poll  iter  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac. 
dialog. h 

fireEntryDialogOefn 

DialogDefn 

Development:SIMNET  ilibmac: 
dialog. h 

Table  2.17-73:  firetarget.c  Variable  Information. 
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2.17.4.1.1  NewFireTarget 


NewFireTarget  allocates  a  record  for  a  new  fire  target  assignment.  The  function  call  is 
NewFireTarget().  Table  2.17-74  describes  the  internal  variable  used  and  function  called 
using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

f 

FireTargetHandle 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

Return  Values 

Return  Value 

Type 

Meaning 

f 

FireTargetHandle 

New  fire  target  handle. 

Calls 

Function 

Where  Described 

NewHandie 

Standard  Memory  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

FireEvent 

See  Section  2.17.1.2.5. 

ReadFireTarqets 

See  Section  2.17.8.1.12. 

LoadCannedFireTargets 

See  Section  2.17.8.2.3. 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17-74:  NewFireTarget  Information. 


2.17.4.1.2  SetUpFireTable 


SetUpFireTable  initializes  the  fire  target  table.  The  function  call  is  SetUpFireTable(). 
Table  2.17-75  describes  the  internal  variable  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

port 

GrafPort 

DevelopmentTHINK  C: 

Mac  #includes:Quickdraw.h 

1  Calls  1 

Function 

Where  Described 

OpenPort 

Standard  Quickdraw  function  for  Macintosh. 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

Text  Size 

Standard  Quickdraw  function  for  Macintosh. 

StringWidth 

Standard  Quickdraw  function  for  Macintosh. 

CharWidth 

Standard  Quickdraw  function  for  Macintosh. 

ShowDialog 

See  Section  2.22.1.11.1. 

1  Called  By  I 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

Table  2.17-75:  SetUpFireTable  Information. 
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2.17.4.1.3  LookupFireTarget 

LookupFireTarget  looks  up  a  fire  target  by  its  target  number,  n.  The  function  call  is 
Lxx)kupFireTarget(n).  Table  2.17-76  describes  the  parameter  used  and  function  called 
using  this  function. 


1  Parameters  I 

Parameter  iTvpe 

Where  Typedef  Declared 

n  1  int 

Standard  C  type. 

Return  Values 

Return  Value 

Type 

Meaning 

LookupScrollTableEntry 
(SfireTableField,  (unsigned 
Iona)  n) 

FireTargetHandle 

The  fire  target  specified  by  n. 

Calls 

Function 

Where  Described 

LookupScrollTableEntry 

See  Section  2.22.1.24.1. 

Called  By 

Function 

Where  Described 

ValidTqtLocation 

See  Section  2.17.1.6.1. 

Table  2.17-76:  LookupFireTarget  Information. 

2.17.4.1.4  ShowFireTable 

ShowFireTable  makes  the  fire  target  table  visible.  The  function  call  is  ShowFireTable(). 
Table  2.17-77  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

ShowWindow 

Standard  Window  Manaqer  function  for  Macintosh. 

Select  Window 

Standard  Window  Manaqer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

Menu  Command 

See  Section  2.17.8.4.5. 

Table  2.17-77;  ShowFireTable  Information. 
2.17.4.1.5  FireTableSelect 

FireTableSelect  checks  the  validity  of  the  Fire  Table  selection  and  enables  the  menus 
describing  the  selection.  The  function  call  is  FireTableSelect(defn,  row,  box,  event). 
Table  2.17-78  describes  the  parameters  used  and  functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentrSIMNET  :libmac. 
scroll.h 

row 

int 

Standard  C  type. 

box 

pointer  to  Rect 

DevekjpmentTHINK  C: 

Mac  #tncludes:MacTypes.h 

event 

pointer  to  EventRecord 

Development:THINK  C: 

Mac  #includes:EventMar.h 

1  Calls  1 

Function 

Where  Described 

Select  ScrollTableEntry 

See  Section  2.22.1.37.1. 

EnableMenus 

See  Section  2.17.8.4.4. 

Table  2.17-78:  FireTableSelect  Information. 


2.17.4.1.6  TableDrawNumber 


TableDrawNumber  fills  in  the  Number  field  of  the  specified  column  in  the  Fire  Target 
scrolling  table.  The  function  call  is  TableDrawNumber(defn,  col,  entry,  box).  Table  2.17- 
79  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentrSIMNET  rlibmac; 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

DevelopmentrSIMNET  rlibmacr 
scroll.h 

entry 

register 

ScrollTableEntryHandle 

DevelopmentrSIMNET  rlibmacr 
scroll.h 

box 

pointer  to  Rect 

DevetopmentrTHINK  Cr 

Mac  #includesrMacTypes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

str 

array  of  1 0  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 

Move 

Standard  Quickdraw  function  for  Macintosh. 

String  Width 

Standard  Quickdraw  function  for  Macintosh. 

Drawstring 

Standard  Quickdraw  function  for  Macintosh. 

1  Called  Bv  1 

Function 

Where  Described 

SchedTableDrawTarget 

See  Section  2.17.4.3.6. 

Table  2.17-79:  TableDrawNumber  Information. 
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2.17.4.1.7  FireTableDrawLocation 


FireTableDrawLocation  fills  in  the  Location  field  of  the  specified  column  in  the  Fire  Target 
scrolling  table.  The  function  call  is  FireTableDrawLocationfdefn,  col,  entry,  box).  Table 
2.17-80  describes  the  parameters  used  and  functions  called  using. this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  :libmac; 
scroll.h 

col 

pointer  to 

ScroKTableColumnDefn 

DevelopmentiSIMNET  :libmac: 
scroll.h 

entry 

register 

ScrollTableEntryHandle 

DevelopmentiSIMNET  ilibmac; 
scroll.h 

box 

pointer  to  Rect 

Development.THINK  C: 

Mac  #includes;MacTypes.h 

_  Internal  Variables  _ 

Variable  [Type  I  Where  Typedef  Declared 

str_ register  pointer  to  char_ Standard  C  type. 


_ _ Calls _ 

Function _ Where  Described _ 

^tandatdQuickdrawfurwtion^forMacintostv_^^______ 

Table  2.17-80:  FireTableDrawLocation  Information. 
2.17.4.1.8  FireTableDrawDescription 

FireTableDrawDescription  fills  in  the  Description  field  of  the  specified  column  in  the  Fire 
Target  scrolling  table.  The  function  call  is  FireTableDrawDescriptionfdefn,  col,  entry, 
boxX  Table  2.17-81  describes  the  parameters  used  and  functions  called  using  this 
function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development:SIMNET  ilibmac: 
scroll.h 

col 

pointer  to 

ScrollT  ableColumnDefn 

DevelopmentiSIMNET  ilibmac; 
scroll.h 

entry 

register 

ScrollTableEntryHandle 

Development  iSIM  N  ETilibmac ; 
scroll.h 

box 

pointer  to  Rect 

DevelopmentiTHINK  C: 

Mac  #includes;MacTvDes.h 

Variable _ Type _ Where  Typedef  Declared 

str_ register  pointer  to  char_ Standard  C  type. 


_ _ Calls _ 

Function _ Where  Described _ 

TextBox  Standard  TextEdit  function  for  Macintosh. 

Table  2.17-81:  FireTableDrawDescription  Information. 
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2.17.4.1.9  FireTableDrawRemarks 


FireTableDrawRemarks  fills  in  the  Remarks  field  of  the  specified  column  in  the  Fire  Target 
scrolling  table.  The  function  call  is  FireTableDrawRemarks(defn,  col,  entry,  box).  Table 
2.17-82  describes  the  parameters  used  and  functions  called  using  this  function. 


Parameters  | 

Parameter 

Tvoe 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development.SIMNET.libmac: 
scroll. h 

col 

pointer  to 

Scroll!  ableColumnDef  n 

DevelopmentiSIMNET  ;libmac; 
scroll,  h 

entry 

register 

ScrollTableEntrvHandle 

DevelopmentiSIMNET  ilibmac: 
scroll. h 

box 

pointer  to  Rect 

DevelopmentiTHINK  C: 

Mac  #includes;MacTvpes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

str 

reqister  pointer  to  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

TextBox 

Standard  TextEdit  function  for  Macintosh. 

Table  2.17-82:  FireTableDrawRemarks  Information. 


2.17.4.1.10  InstallFireTarget 

InstallFireTarget  inserts  a  new  fire  target,/,  in  the  table.  The  function  call  is 
InstallFireTarget(f).  Table  2.17-83  describes  the  parameter  used  and  function  called  using 
this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

f 

FireTargetHandle 

DevelopmentiSIMNET  iMCCi 
FSEiFSEMac.h 

Calls 

Function 

Where  Described 

InstallScrollTableEntry 

See  Section  2.22.1.21.1. 

Called  By 

Function 

Where  Described 

ReadFireTargets 

See  Section  2.17.8.1.12. 

LoadCannedFireTarqets 

See  Section  2.17.8.2.3. 

Table  2.17-83:  InstallFireTarget  Information. 
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2.17.4.1.11  ShowFireTarget 


ShowFireTarget  displays  a  dialog  which  allows  editing  of  a  fire  target,/.  The  function  call 
is  ShowFireTarget  (f,  zoom).  Table  2. 17-84  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  1 

Parameter 

Where  Tvoedef  Declared 

f 

FireTargetHandle 

Development:SIMNET  ;MCC; 
FSE;FSEMac.h 

zoom 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

ShowDialoq 

See  Section  2.22.1.11.1. 

ZoomScrollTableEntry 

See  Section  2.22.1.36.1. 

Show  Window 

Standard  Window  Manaoer  function  for  Macintosh. 

1  Called  Bv  1 

Function 

Where  Described 

FireEvent 

See  Section  2.17.1.2.5. 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17-84:  ShowFireTarget  Information. 
2.17.4.1.12  FireEntryEvent 


FireEntryEvent  handles  events  in  the  Fire  Target  Entry  dialog.  The  function  call  is 
FireEntryEvent(dialog,  itemNo).  Table  2.17-85  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  OialogState 

Developmenf.SIMNET  :libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

InstailScrollTableEntry 

See  Section  2.22.1.21.1. 

Hide  Window 

Standard  Window  Manaqer  function  for  Macintosh. 

ZoomScrollTableEntry 

See  Section  2.22.1.36.1. 

UnhookFireTarqet 

See  Section  2.17.4.1.15. 

RemoveScrollTableEntry 

See  Section  2.22.1.28.1 

ThrowDialoq 

See  Section  2.22.1.11.3. 

Table  2.17-85:  FireEntryEvent  Information. 
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2.17.4.1.13 


ValldNewFireTarget 


ValidNewFireTarget  checks  the  validity  of  the  new  entry  in  the  Fire  Target  table.  The 
function  call  is  ValidNewFireTarget(dialog,  fjp,  str).  Table  2.17-86  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


dialog 


Parameters 


e 


pointer  to  DialogState 


pointer  to  TypeInFieldDefn 


inter  to  char 


l!^ 


Where  Tvoedef  Declared 


DevelopmentiSIMNET  ;hbmac: 
dialOQ.h 


Development;SIMNET  ;libmac: 
dialOQ  h 


Standard  C  type. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

e 

register 

ScrollTableEntryHandle 

Deyelopment;SIMNET  :libmac: 
scroll. h 

array  of  80  char 


Return  values 


Standard  C  type. 


Return  Value 

Type 

0 

int 

1 

int 

Meanin 


Valid  new  fire  target. 


Function 


LookupScrollTableEnt 


ShowCaution 


Calls 


Where  Described 


See  Section  2.22.1.24.1. 


See  Section  2.22.1.4.1, 


Table  2.17-86:  ValidNewFireTarget  Information. 
2.17.4.1.14  UndoFireTarget 

UndoFireTarget  undoes  changes  in  the  fire  target  entry.  The  function  call  is 
UndoFireTarget().  Table  2.17-87  describes  the  function  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

UpdateDialoq 

See  Section  2.22.1.11.2. 

Called  By 

Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17-87:  UndoFireTarget  Information. 
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2.17.4.1.15 


UnhookFireTarget 


UnhookFireTarget  removes  all  references  to  a  fire  target,/,  which  is  about  to  be  deleted. 
The  function  call  is  UnhookFireTarget(defn,  f).  Table  2.17-88  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development.SIMNET.libmac. 

scroll.h 

f 

FireTargetHandle 

Development:SIMNET  ;MCC: 
FSE:FSEMac.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

schedTableFiekJ 

extern  ScrollTableFieldDefn 

DevelopmentiSIMNET  :libmac; 
scroll.h 

m 

register  pointer  to  Mission 

Developmenf.SIMNET  :MCC; 
FSE:FSEMac.h 

s 

register  SchedMissionHandle 

DevelopmenttSIMNET  ;MCC: 
FSEiFSEMac.h 

i 

register  short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

RedrawMissionIcon 

See  Section  2.17.2.2.5. 

1  Called  By  1 

Function 

Where  Described 

FireEntryEvent 

See  Section  2.17.4.1.12. 

WipeFireTable 

See  Section  2.17.8.1.13. 

Table  2.17-88:  UnhookFireTarget  Information. 

2.17.4.2  fpftarget.c 

Development:SIMNET:MCC:FSE:fpftarget.c 


fpftarget.c  implements  a  dialog  containing  a  scrolling  table  of  final  protective  fire  targets. 
Table  2.17-89  describes  the  variables  used  in  fpftarget.c. 
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Variables 

Variable 

Where  Typedef  Declared 

fpfTableDialogDefn 

extern  DialogDefn 

Development:SIMNET  :libmac; 
dialog.h 

fpfEntryDialogDefn 

extern  DialogDefn 

Development;SIMNET;libmac: 

dialog.h 

fpfTableField 

extern  ScrollTableFieldDefn 

Development:SIMNET  ilibmac: 
scroll,  h 

fpfTableColumns 

extern  array  of 

ScrollT  ableColumnDef  n 

DevelopmentiSIMNET  ;libmac: 
scroll,  h 

fpf  Table  Dialog 

pointer  to  DialogState 

Development:SIMNET;libmac. 

dialog.h 

currentFPFTarget 

FPFTargetHandle 

DevelopmentiSIMNET  ;MCC: 
FSE:FSEMac.h 

fpfTargetBuffer 

FPFT  arget  Descriptor 

Development'.SIMNET  :MCC: 
FSE:FSEMac.h 

f  pf  TqtN  u  mbe  rBuff  e  r 

int 

Standard  C  type. 

fpfTableColumns 

array  of 

ScrollT  ableColumnDef  n 

Development:SIMNET  :libmac: 
scroll. h 

fpfTableField 

ScrollTableFieldDefn 

Development:SIMNET  :libmac: 
scroll,  h 

fpfTableFieldList 

pointer  to  array  of  FieldDef  n 

Development:SIMNET  :libmac; 
dialog.h 

fpfTableDialogDefn 

DialogDefn 

Development:SIMNET  :libmac: 
dialog.h 

fpfEntryDeleteField 

PushButtonFieldDefn 

Development:SIMNET  :libmac: 
dialog.h 

fpfEntryNumberField 

NumberFieldDefn 

Development:SIMNET  ilibmac: 
dialog.h 

fpfEntryLocationFields 

array  of  CoordinatesFieldDefn 

Development:SIMNET  :libmac: 
dialog.h 

fpfEntryDescriptionField 

TextFieldDefn 

Development;SIMNET  :libmac: 
dialog.h 

fpfEntryFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

fpfEntryDialogDefn 

DialogDefn 

DevelopmentiSIMNET  :libmac: 
dialog.h 

Table  2.17-89:  fpftarget.c  Variable  Information. 

2.17.4.2.1  NewFPFTarget 

NewFPFTarget  allocates  a  record  for  a  new  FPF  target  assignment.  The  function  call  is 
NewFPFTarget().  Table  2.17-90  describes  the  internal  variable  used  and  function  called 
using  this  function. 


Variable 


Internal  Variables 


e 


FPFTargetHandle 


Where  Tvoedef  Declared 


Development:SIMNET  :MCC: 
FSE:FSEMac.h 


Return  Value 


Return  Values 


Type 


FPFTargetHandle 


Meaning 


New  FPF  target. 
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Calls 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manager  function  for  Macintosh. 

* 

Called  By 

Function 

Where  Described 

ReadFPFTaraets 

See  Section  2.17.8.1.15. 

LoadCannedFPFTarqets 

See  Section  2.17.8.2.4. 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17-90:  NewFPFTarget  Information. 


2.17.4.2.2  SetUpFPFTable 


SetUpFPFTable  initializes  an  FPF  target  table.  The  function  call  is  SetUpFPFTable(). 
Table  2.17-91  describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

port 

Graf  Port 

DevelopmentiTHINK  C: 

Mac  #includes:Quickdraw.h 

Calls 

Function 

Where  Described 

OpenPort 

Standard  Quickdraw  function  for  Macintosh. 

TextFont 

Standard  Quickdraw  function  for  Macintosh. 

TextSize 

Standard  Quickdraw  function  for  Macintosh. 

String  Width 

Standard  Quickdraw  function  for  Macintosh. 

CharWidth 

Standard  Quickdraw  function  for  Macintosh. 

ShowDialog 

See  Section  2.22.1.11.1. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

Table  2.17-91:  SetUpFPFTable  Information. 


2.17.4.2.3  ShowFPFTable 

ShowFPFTable  makes  an  FPF  target  table  visible.  The  function  call  is  ShowFPFTable(). 
Table  2.17-92  describes  the  functions  called  using  this  function. 


_ _ Calls _ 

Function  I  Where  Described 

ShowWindow _ Standard  Window  Manager  function  for  Macintosh- 

Select  Window_ Standard  Window  Manager  tunction  tor  Macintosh. 


Called  B 


Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17-92:  ShowFPFTable  Information. 
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2.17.4.2.4  FPFTableSelect 


FPFTableSelect  checks  for  the  validity  of  the  selection  and  enables  menus  pertaining  to  the 
selection.  The  function  call  is  FPFTableSelect(defn,  row,  box,  event).  Table  2.17-93 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

^rollTableFieldDefn 

Development.SIMNET.libmac. 

scroll.h 

row 

int 

Standard  C  type. 

box 

pointer  to  Rect 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

event 

pointer  to  EventRecord 

Development:THINK  C; 

Mac  #includes;EventMQr.h 

1  Calls  1 

Function 

Where  Described 

SelectScrollTable  Entry 

See  Section  2.22.1.37.1. 

EnabieMenus 

See  Section  2.17.8.4.4. 

Table  2.17-93:  FPFTableSelect  Information. 
2.17.4.2.5  FPFTableDrawNumber 


FPFTableDrawNumber  fills  in  the  Number  field  of  the  specified  column  in  the  FPF  Table. 
The  function  call  is  FPFTableDrawNumber(defn,  col,  entry,  box).  Table  2.17-94 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

col 

pointer  to 

Scroll!  ableColumnDef  n 

Development:SIMNET  :libmac; 
scroll.h 

entry 

register 

ScrollTableEntryHandle 

Development:SIMNET  :libmac; 
scroll.h 

box 

pointer  to  Rect 

DevelopmentiTHINK  C; 

Mac  #includes;MacTypes.h 

internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

str 

array  of  255  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 

Move 

Standard  Quickdraw  function  for  Macintosh. 

StringWidfh 

Standard  Quickdraw  function  for  Macintosh. 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.17-94:  FPFTableDrawNumber  Information. 
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2.17.4.2.6  FPFTableDrawLeft 


FPFTableDrawLeft  fills  in  the  Left  field  of  the  specified  column  in  the  FPF  Table.  The 
function  call  is  FPFTableDrawLeft(defn,  col,  entry,  box).  Table  2.17-95  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


defn 


IE173 


Parameters 


e 


pointer  to 

ScrollTableFieldDefn 


pointer  to 

^rollTableColumnDefn 


register 

ScrollTableEntryHandle 


pointer  to  Rect 


Where  Typedef  Declared 


Oevelopment;SIMNET;libmac; 

scroll.h 


Development;SIMNET  :libmac; 
scroll.h 


Development.SIMNET  ;libmac: 
scroll.h 


DevelopmentTHINK  C: 
Mac  #includes;MacTvpes.h 


Variable 


str 


Internal  Variables 


e 


reoister  pointer  to  char 


Where  Typedef  Declared 


Standard  C  type. 


Function 


DrawText 


Calls 


Where  Described 


Standard  Quickdraw  function  for  Macintosh. 


Table  2.17-95:  FPFTableDrawLeft  Information. 

2.17.4.2.7  FPFTableDrawRight 

fT*FTableDrawRight  fills  in  the  Right  field  of  the  specified  column  in  the  FPF  Table.  ITie 
function  call  is  FPFTableDrawRight(defn,  col,  entry,  box).  Table  2.17-96  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTable  FieldDef  n 

Deyelopment:SIMNET  :libmac: 
scroll.h 

col 

pointer  to 

•ScroIlTableColumnDefn 

Deyelopment:SIMNET  :libmac: 
scroll.h 

entry 

register 

ScrollTableEntryHandle 

Development;SIMNET;libmac. 

scroll.h 

box 

pointer  to  Rect 

DeyelopmentiTHINK  C; 

Mac  #includes:MacTypes.h 

Variable 


str 


Internal  Variables 


e 


reoister  pointer  to  char 


Where  Typedef  Declared 


Standard  C  type. 


Calls 


Function  Where  Described 


DrawText  Standard  Quickdraw  function  for  Macintosh. 


Table  2.17-96:  FPFTableDrawRight  Information. 
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2.17.4.2.8  FPFTableDrawDescri ption 

FPFTableDrawDescription  fills  in  the  Description  field  of  the  specified  column  in  the  FPF 
Table.  The  function  call  is  FPFTableDrawI)escription(defn,  col,  entry,  box).  Table  2.17- 
97  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvoedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  rlibmac; 
scroll. h 

col 

pointer  to 

ScrollTableColumnDefn 

Development:SIMNET  :libmac: 
scroll. h 

entry 

register 

Scroll!  able  EntryHandle 

DevelopmentiSIMNET  ;libmac: 
scroll.h 

box 

pointer  to  Red 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

str 

reqister  pointer  to  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

TexiBox 

Standard  TextEdit  fundion  for  Macintosh. 

Table  2.17-97;  FPFTableDrawDescription  Information. 
2.17.4.2.9  InstallFPFTarget 

InstallFPFTarget  inserts  a  new  FPF  target,/,  in  the  table.  The  function  call  is 
InstallFPFTarget(f).  Table  2.17-98  describes  the  parameter  used  and  function  called  using 
this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

f 

FPFTargetHandle 

DevelopmentiSIMNET  :MCC; 
FSEiFSEMac.h 

Calls 

Function 

Where  Described 

InstallScrollTableEntry 

See  Section  2.22.1.21.1. 

Called  By 

Function 

Where  Described 

ReadFPFTargets 

See  Section  2.17.8.1.15. 

LoadCannedFPFTarqets 

See  Section  2.17.8.2.4. 

Table  2.17-98:  InstallFPFTarget  Information. 
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2.17.4.2.10  ShowFPFTarget 


ShowFPFTarget  displays  a  dialog  which  allows  the  editing  of  an  FPF  target,/.  The 
function  call  is  ShowFPFTarget(f,  zoom).  Table  2.17-99  describes  the  parameters  used 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

f 

FPFTargetHandle 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

zoom 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

ShowDialoq 

See  Section  2.22.1.11.1. 

ZoomScrollTableEntry 

See  Section  2.22.1.36.1. 

ShowWindow 

Standard  Window  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17-99:  ShowFPFTarget  Information. 

2.17.4.2.11  FPFEntryEvent 

FPFEntryEvent  handles  events  in  the  FPF  dialog.  The  function  call  is 
FPFEntryEvent(dialog,  itemNo).  Table  2.17-100  describes  the  parameters  used,  errors 
returned  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedet  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

itemNo 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

CheckMandatoryFields 

See  Section  2.22.1.13.1. 

InstallScrollTableEntry 

See  Section  2.22.1.21.1. 

Hide  Window 

Standard  Window  Manager  function  for  Macintosh. 

ZoomScrollTableEntry 

See  Section  2.22.1.37.1. 

RemoveScrollTableEntry 

See  Section  2.22.1.28.1. 

ThrowDialoq 

See  Section  2.22.1.11.3. 

Table  2.17-100:  FPFEntryEvent  Information. 
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2.17.4.2.12  ValidNewFPFTarget 


ValidNewFPFTarget  checks  the  validity  of  the  new  FPF  Target  entry.  The  function  call  is 
ValidNewFPFTarget(dialog,  fp,  str).  Table  2.17-101  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Development:SIMNET  :libmac: 
scroll. h 

IP 

pointer  to  TypeInFieldDefn 

Development:SIMNET  :libmac; 
scroll.h 

str 

pointer  to  char 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

e 

register 

ScrollT  able  EntryHandle 

Development:SIMNET  :libmac: 
scroll.h 

b 

array  of  80  char 

Standard  C  type. 

1  Return  Values  I 

Return  Value 

Type 

Meaning 

0 

int 

New  FPF  target  not  valid. 

1 

int 

New  FPF  target  valid. 

I  Calls  I 

Function 

Where  Described 

LookupScrollTable  Entry 

See  Section  2.22.1.24.1. 

ShowCaufion 

See  Section  2.22.1.4.1. 

Table  2.17-101:  ValidNewFPFTarget  Information. 


2.17.4.2.13  UndoFPFTarget 


UndoFPFTarget  undoes  any  changes  in  the  FPF  target  entry.  The  function  call  is 
UndoFPFTargetQ.  Table  2.17-102  describes  the  function  called  using  this  function. 


1  Calls  1 

1  Function 

Where  Described 

|l|  1 1 II 1 II II 1  — 

See  Section  2,22.1.11.2. 

1  Called  By  1 

Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17-102:  UndoFPFTarget  Information. 
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2.17.4.3  schedule.c 

Development:SIMNET:MCC:FSE:schedule.c 

schedule.c  implements  a  dialog  containing  a  scrolling  table  of  prescheduled  fire  missions 
and  controls  the  initiation  of  prescheduled  missions.  Table  2.17-.103  describes  the 
variables  used  in  schedule.c. 


Variables 


Variable 

Where  Tvpedef  Declared 

schedlableDialogDefn 

extern  DialogOefn 

Development:SIMNET  :libmac: 
dialog. h 

sched  Entry  DialogOefn 

extern  DialogOefn 

Development:SIMNET  ilibmac: 
dialog. h 

schedTableField 

extern  ScrollTableFieldDefn 

Development.SIMNET.libmac; 
scroll. h 

schedT  ableColumns 

extern  array  of 
ScrollTableColumnDefn 

Development:SIMNET  :libmac: 
scroll.h 

schedlable  Dialog 

pointer  to  DialogState 

Development:SIMNET  ilibmac: 
dialog. h 

currentSchedMission 

SchedMissionHandle 

Development.SIMNET.MCC: 

FSE:FSEMac.h 

schedMissionBuffer 

SchedMissionDescriptor 

Development:SIMNET  :MCC: 
FSE.FSEMac.h 

schedTargetBuffer 

T  argetLocationBuff  er 

DevelopmentiSIMNET  :MCC: 
FSE:FSEMac.h 

schedTableColumns 

array  of 

ScrollTableColumnDefn 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

schedTableField 

ScrollT  ableFieldDef  n 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

schedT  ableFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

schedTableDialogDefn 

DialogOefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

schedDeleteField 

PushButtonFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

schedTimeField 

DTGFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

schedTargetField 

TextFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

schedAmmoFields 

array  of  RBFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

schedBatteryFields 

array  of  CBFieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

schedRoundsField 

NumberFiekjDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

schedEntryFieldList 

pointer  to  array  of  FieldDefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

schedEntryDialogDefn 

DialogOefn 

DevelopmentiSIMNET  ilibmaci 
dialog. h 

Table  2.17-103:  schedule.c  Variable  Information. 
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NewSchedMission  allocates  a  record  for  a  new  scheduled  fire  mission.  The  function  call  is 
NewSchedMissionQ.  Table  2.17-104  describes  the  internal  variables  used  and  function 
called  using  this  function. 


Variable 


s 


Internal  Variables 


e  Where  Typedef  Declared 


register  SchedMission  Handle  DevelopmentiSIMNET ;MCC; 

FSE:FSEMac.h 


short  Standard  C  t 


short  Standard  C  type. 


Return  Value 


s 


Return  Values 


Type _ 


SchedMissionHandle 


Meanin 


New  scheduled  fire  mission. 


Calls 

Function 

Where  Described 

NewHandle 

Standard  Memory  Manager  function  for  Macintosh. 

Called  B 


Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17*104:  NewSchedMission  Information. 
2.17.4.3.2  SetUpSchedTable 

SetUpSchedTable  initializes  a  fire  mission  schedule.  The  function  call  is 
SetUpSchedTable().  Table  2.17-105  describes  the  internal  variable  used  and  functions 
called  using  this  function. 


Variable 


port 


Internal  Variables 


e 


GrafPort 


Where  Typedef  Declared 


DevelopmentiTHINK  C: 
Mac  #includes:Ouickdraw.h 


Function 


OuenPort 


TextFont 


TextSize 


Stri  no  Width 


ShowDialo 


Calls 


Where  Described 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


Standard  Quickdraw  function  for  Macintosh. 


See  Section  2.22.1.11.1. 


Function 


main 


Called  B 


Where  Described 


See  Section  2.17.8.3.1. 


Table  2.17-105:  SetUpSchedTable  Information. 
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2.17.4.3.3  ShowSchedTable 

ShowSchedTable  makes  a  fire  mission  schedule  visible.  The  function  call  is 
ShowSchedTableO.  Table  2.17-106  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

ShowWindow 

Standard  Window  Manager  function  for  Macintosh. 

Select  Window 

Standard  Window  Manager  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17-106:  ShowSchedTable  Information. 

2.17.4.3.4  SchedTableSelect 

SchedTableSelect  checks  for  validity  of  theSchedule  Table  selection.  The  function  call  is 
SchedTableSelect(defn,  row,  box,  event).  Table  2.17-107  describes  the  parameters  used 
and  functions  called  using  this  function. 


I  Parameters  | 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  :libmac: 
scroll. h 

row 

int 

Standard  C  type. 

box 

pointer  to  Red 

DevelopmentTHINK  C: 

Mac  #includes:MacTypes.h 

event 

pointer  to  EventRecord 

Development  THINK  C: 

Mac  #includes:EventMor.h 

I  Calls  I 

Function 

Where  Described 

SelectScroIlTableEntrv 

See  Section  2.22.1.37.1. 

EnableMenus 

See  Section  2.17.8.4.4. 

Table  2.17-107: 


SchedTableSelect  Information. 
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2.17.4.3.5  SchedTableDrawTime 


SchedTableDrawTime  fills  in  the  Time  field  of  the  specified  column  in  the  Schedule  Table. 
The  function  call  is  SchedTableDrawTime  (defn,  col,  entry,  box).  Table  2.17-108 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

col 

pointer  to 

ScroliT  ableColumnDef  n 

DevelopmentiSIMNET  ilibmac: 
scroll.h 

entry 

register 

ScroiiT  abieEntrvHandle 

Development:SIMNET  ilibmac; 
scroll.h 

box 

pointer  to  Rect 

Development:THINK  C: 

Mac  #includes:MacTvpes.h 

Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

s 

register  SchedMissionHandie 

Development:SIMNET  :MCC; 
FSE:FSEMac.h 

str 

array  of  20  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

DTGToString 

See  Section  2.22.1.15.1. 

DrawText 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.17-108:  SchedTableDrawTime  Information. 


2.17.4.3.6  SchedTableDrawTarget 


SchedTableDrawTarget  fills  in  the  Target  field  of  the  specified  column  in  the  Schedule 
Table.  The  function  call  is  SchedTableDrawTargetfdefn,  col,  entry,  box).  Table  2.17-109 
describes  the  parameters  used  and  functions  call^  using  this  function. 


I  Parameters  | 

Parameter 

Type 

Where  Tvpedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development;SIMNET  :libmac: 
scroll.h 

col 

pointer  to 

ScroliT  ableColumnDef  n 

DevetopmentiSIMNET  ilibmac; 
scroll.h 

entry 

ScrollTableEntryHandle 

DevelopmentiSIMNET  ilibmac; 
scroll.h 

box 

pointer  to  Rect 

DevelopmentiTHINK  C; 

Mac  #includes;MacTypes.h 

Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

s 

registf  SchedMissionHandie 

DevelopmentiSIMNET  iMCC; 
FSEiFSEMac.h 

I  I 
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1  Calls  1 

Function 

Where  Described 

TableDrawNumber 

See  Section  2.17.4.1.6. 

DrawText 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.17-109:  SchedTableDrawTarget  Information. 


2.17.4.3.7  SchedT ableDrawDescription 


SchedTableDrawDescription  fills  in  the  Description  field  of  the  specified  column  in  the 
Schedule  Table.  The  function  call  is  SchedTableDrawDescription  (defn,  col,  entry,  box). 
Table  2.17-1 10  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Tvoe 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  :libmac: 
scroll. h 

col 

pointer  to 

ScrollTableColumnDefn 

DevelopmentiSIMNET  ilibmac: 
scroll,  h 

entry 

ScrollTableEntryHandle 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

box 

pointer  to  Rect 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTypes.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

s 

register  SchedMissionHandle 

DevelopmentiSIMNET  iMCCi 
FSEiFSEMac.h 

str 

register  pointer  to  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

TextBox 

Standard  TextEdit  function  for  Macintosh. 

Table  2.17-110:  SchedTableDrawDescription  Information. 


2.17.4.3.8  SchedTableDrawUnits 


SchedTableDrawUnits  fills  in  the  Units  field  of  the  specified  column  in  the  Schedule  Table. 
The  function  call  is  SchedTableDrawUnits(defn,  col,  entry,  box).  Table  2.17-1 1 1 
describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

col 

pointer  to 

ScrollT  ableColumnDefn 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

entry 

register 

ScrollTableEntryHandle 

DevelopmentiSIMNET  ilibmaci 
scroll.h 

box 

pointer  to  Rect 

DevelopmentiTHINK  Ci 

Mac  #includesiMacTypes.h 

1^  ^  ^  ^  n 
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1  Internal  Variables  1 

Variable 

Type 

Where  Tvpedef  Declared 

s 

register  SchedMissionHandle 

DevelopmentiSIMNET  :MCC; 
FSE:FSEMac.h 

i 

register  short 

Standard  C  type. 

battervTypeName 

pointer  to  array  of  char 

Standard  C  type. 

batteryType 

array  of  numberBatteryTypes 
char 

Standard  C  type. 

Calls 

Function 

Where  Described 

DrawStrinq 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.17-111:  SchedTableDrawUnits  Information. 
2.17.4.3.9  SchedTableDrawRounds 

SchedTableDrawRounds  fills  in  the  Rounds  field  of  the  specified  column  in  the  Schedule 
Table.  The  function  call  is  SchedTableDrawRounds(defn,  col,  entry,  box).  Table  2.17- 
112  describes  the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Devetopment:SIMNET  'ibmac: 
scroll. h 

col 

pointer  to 

Scro  IIT  ableCoiu  mnDef  n 

Development:SIMNET  :libmac. 
scroll.h 

entry 

ScrollTable  Entry  Handle 

Developmenf.SIMNET  ;libmac: 
scroll.h 

box 

pointer  to  Red 

DevelopmentTHINK  C: 

Mac  #includes:MacTvpes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

s 

register  SchedMissionHandle 

DevelopmentiSIMNET  :MCC: 
FSE:FSEMac.h 

str 

array  of  1 0  char 

Standard  C  type. 

Calls 

Function 

Where  Described 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  fundion  for 
Macintosh. 

Move 

Standard  Quickdraw  fundion  for  Macintosh. 

String  Width 

Standard  Quickdraw  function  for  Macintosh. 

Drawstring 

Standard  Quickdraw  fundion  for  Macintosh. 

Table  2.17-112;  SchedTableDrawRounds  Information. 
2.17.4.3.10  SchedTableDrawStatus 

SchedTableDrawStatus  fills  in  the  Status  field  of  the  specified  column  in  the  Schedule 
Table  The  function  call  is  SchedTableDrawStatus(defn,  col.  entry,  box).  Table  2.17-1 13 
describes  the  parameters  used  and  functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Tvoe 

Where  Tvoedef  Declared 

deIn 

pointer  to 

ScrollTableFieldDefn 

Development:SIMNET  ilibmac; 
scroll.h 

col 

pointer  to 

ScrollTableColumnDefn 

Development:SIMNET  ilibmac; 
scroll.h 

entry 

ScrollTableEntryHandle 

DevelopmentiSIMNETiiibmac; 

scroll.h 

box 

pointer  to  Rect 

DevekjpmentiTHINK  C: 

Mac  #includes;MacTypes.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

s 

register  SchedMissionHandle 

DevelopmentiSIMNET  iMCC: 
FSEiFSEMac.h 

statusStrina 

pointer  to  array  of  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

Drawstring 

Standard  Quickdraw  function  for  Macintosh. 

TextFace 

Standard  Quickdraw  function  for  Macintosh. 

Table  2.17-113:  SchedTableDrawStatus  Information. 


2.17.4.3.11  ShowSchedMission 


ShowSchedMission  displays  a  dialog  which  allows  editing  of  a  scheduled  mission,  s.  The 
function  call  is  ShowSchedMission(s,  zoom).  Table  2.17-1 14  describes  the  parameters 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

s 

SchedMissionHandle 

DeyelopmentiSIMNET  iMCC: 
FSEiFSEMac.h 

zoom 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

NumToString 

Standard  Binary  to  Decimal  Conyersion  Package  function  for 
Macintosh. 

ShowDialog 

See  Section  2.22.1.11.1. 

ZoomScrollTableEntry 

See  Section  2.22.1.36.1. 

Show  Window 

Standard  Window  Manager  function  for  Macintosh. 

EstablishBattenrSelection 

See  Section  2.17.5.2.1. 

Called  By 

Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17-114:  ShowSchedMission  Information. 
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2.17.4.3.12  SchedEntryEvent 


SchedEntryEvent  handles  events  in  the  Schedule  Entry  dialog.  The  function  call  is 
SchedEntryEvent(dialog,  itemNo).  Table  2.17-115  describes  the  parameters  used  and 
functions  called  using  this  function. 


I  Parameters  I 

Parameter 

Type 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

Development;SIMNET  :libmac; 
dialog. h 

itemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Tvpedef  Declared 

i 

short 

Standard  C  type. 

i 

short 

Standard  C  type. 

batteriesChosen 

short 

Standard  C  type. 

Calls 

Function 

Where  Described 

CheckMandatorvFields 

See  Section  2.22.1.13.1. 

ShowCaution 

See  Section  2.22.1.4.1. 

InstallScrollTableEntfv 

See  Section  2.22.1.21.1. 

Hide  Window 

Standard  Window  Manager  function  for  Macintosh. 

ZoomScrollTableEntrv 

See  Section  2.22.1.36.1. 

RemoveScrollTableEntrv 

See  Section  2.22.1.28.1. 

ThrowDialoq 

See  Section  2.22.1.11.2. 

Table  2.17-115:  SchedEntryEvent  Information. 


2.17.4.3.13  ValidTime 


ValidTime  checks  to  see  if  a  valid  time  has  been  entered  in  the  Schedule  Table.  The 
function  call  is  ValidTime(dialog,  fp,  str).  Table  2.17-1 16  describes  the  parameters  used 
and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

dialog 

pointer  to  DialogState 

Deyelopment;SIMNET  :libmac: 
dialog.h 

fp 

pointer  to  DTGFieldDefn 

Development:SIMNET:libmac; 

dialog.h 

str 

register  pointer  to  char 

Standard  C  type. 

Variable 


now 


Internal  Variables 


e 


Where  Tvpedef  Declared 


Standard  C  t 


Return  Values 


Type 


Meanin 


int 

No  valid  time  entered. 

int 

Valid  time  entered. 

Return  Value 

0 _ 

1 
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Calls 

Function 

Where  Described 

GetDateTime 

Standard  Operatina  System  Utility  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

Table  2.17-116:  ValidTime  Information. 


2.17.4.3.14  UndoSchedMission 


UndoSchedMission  undoes  changes  in  a  scheduled  fire  mission  entry.  The  function  call  is 
UndoSchedMission().  Table  2.17-1 17  describes  the  functions  called  using  this  function. 


I  Calls  I 

Function 

Where  Described 

NumToString 

Standard  Binary  to  Decimal  Conversion  Package  function  for 
Macintosh. 

|i|  I  III  Ml II I 

See  Section  2.22.1.11.2. 

Called  By 

Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17-117:  UndoSchedMission  Information. 


2.17.4.3.15  StartSchedMission 


StartSchedMission  is  called  when  a  scheduled  fire  mission,  s,  is  due  to  begin.  The  routine 
checks  that  the  mission  is  not  being  edited  and  that  all  the  requested  guns  are  available.  An 
unused  mission  descriptor  is  found  and  filled  in.  The  routine  checks  that  the  guns  have 
ammo  and  can  reach  the  target  before  they  are  assigned  to  the  mission.  The  guns  are  fired, 
and  the  mission  schedule  is  updated  to  show  that  the  mission  is  in  progress.  The  function 
call  is  StartSchedMission(s).  Table  2.17-1 18  describes  the  parameter  used  and  functions 
called  using  this  function. 
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1  Calls  1 

Function 

Where  Described 

ShowCaution 

See  Section  2.22.1.4.1. 

SetSchedMission 

See  Section  2.17.4.3.16. 

BattervSelectionViable 

See  Section  2.17.5.1.9. 

EndMission 

See  Section  2.17.8.5.2. 

AppIvToBatteries 

See  Section  2.17.5.1.5. 

UpdateBattervSelection 

See  Section  2.17.5.2.2. 

FireVolley 

See  Section  2.17.5.1.2. 

UpdateMissionDisplay 

See  Section  2.17.8.5.5. 

Called  By 

Function 

Where  Described 

CheckTimers 

See  Section  2.17.5.1.1. 

Table  2.17-118:  StartSchedMission  Information. 

2.17.4.3.16  SetSchedMission 

SetSchedMission  sets  the  status,  status,  of  a  scheduled  mission,  5.  The  function  call  is 
SetSchedMission(s,  status).  Table  2.17-1 19  describes  the  parameters  used  and  functions 
called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

s 

SchedMissionHandle 

DevelopmentiSIMNET  :MCC: 
FSE-.FSEMac.h 

status 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

UpdateScrollTable  Entry 

See  Section  2.22.1.31.1. 

EnableMenus 

See  Section  2.17.8.4.4. 

Called  By 

Function 

Where  Described 

StartSchedMission 

See  Section  2.17.4.3.15. 

CheckFirinq 

See  Section  2.17.1.3.6. 

FireVolley 

See  Section  2.17.5.1.2. 

ReadSchedMissions 

See  Section  2.17.8.1.18. 

Table  2.17-119: 
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2.17.5  Model  Operation  of  Artillery  Batteries 


2.17.5.1  model. c 

Development:SIMNET:MCC:FSE:model.c 

modelc  contains  routines  that  model  the  firing  of  shells  by  artillery  batteries.  Table  2.17- 
120  describes  the  variables  used  in  model.c. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

schedTableField 

extern  ScrollTableFieldDefn 

Development;SIMNET  ilibmac; 
scroll.h 

Table  2.17-120:  model.c  Variable  Information. 

2.17.5.1.1  CheckTimers 

CheckTimers  looks  for  any  time-driven  changes  in  status.  The  routine  checks  for  any 
missions  which  are  ready  to  fire  another  round  or  report  "splash".  Scheduled  fire  missions 
which  are  due  to  begin  are  checked.  Positions  of  displacing  fire  units  are  updated.  The 
function  call  is  CheckTimersQ.  Table  2.17-121  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

m 

register  pointer  to  Mission 

Development:SIMNET  :MCC; 
FSE:FSEMac.h 

s 

register 

SchedMisssionHandle 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

hp 

register  pointer  to  struct  Halt 

Development:SIMNET  :MCC; 
FSE:FSEMac.h 

t 

reaister  unsigned  Iona 

Standard  C  type. 

now 

unsigned  long 

Standard  C  type. 

mission 

short 

Standard  C  type. 

battery 

short 

Standard  C  type. 

halt 

short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetDateTime 

Standard  Operating  System  Utility  tunction  tor  Macintosh. 

FireVolley 

See  Section  2.17.5.1.2. 

UpdateMissionState 

See  Section  2.17.8.5.6. 

Start  SchedMission 

See  Section  2.17.4.3.15. 

1  iijffgiHsnifmsrotiM 

See  Section  2.17.2.1.7. 

U  pdate  BatterySe  lectio  n 

See  Section  2.17.5.2.2. 

LocalUnitDispatched 

See  Section  2.17.3.2.1. 

LocalUnitArrived 

See  Section  2.17.3.2.2. 

UpdateUnitLocation 

See  Section  2.17.3.2.6. 
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Function 


MainEventLoo 


Called  B 


Where  Described 


See  Section  2.17.8.3.3. 


Table  2.17-121:  CheckTimers  Information. 

2.17.5.1.2  FireVolley 

FireVolley  fires  a  volley  for  a  mission,  m.  Volleys  are  fired  on  a  per-battery  basis.  If  the 
batter  is  not  participating,  it  is  ignored.  If  firing  FPF,  the  fuze  that  the  battery  has  most  of 
is  chosen.  Eiach  battery  half  assigned  to  the  mission  is  intialized  on  the  first  volley,  then 
checked  on  subsequent  volleys.  The  function  call  is  FireVoUey(m,  first).  Table  2.17-122 
describes  the  parameters  used  and  functicMis  called  using  this  function. 


Parameter 


m 


Parameters 


register  pointer  to  Mission 


Where  Tvoedef  Declared 


Development:SIMNET  :MCC: 
FSE:FSEMac.h 


Standard  C  type. 


Variable 


now 


newReadyTime 


newSolashTime 


t 


ammo 


halfFired 


target 


Internal  Variables 


e 


register  pointer  to  Battery 


register  pointer  to  struct  Half 


unsioned  Ion 


unsioned  Ion 


unsigned  Ion 


unsigned  Ion 


short 


short 


short 


short 


pointer  to  LongPt 


pointer  to  Performance 


Where  Tvpedef  Declared 


Development:SIMNET  :MCC: 
FSE:FSEMac.h 


Development  iSIMNET  :MCC: 
FSE:FSEMac.h 


Standard  C  type. 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  type. 


Standard  C  t 


Deyelopment:SIMNET  :libmac: 
longpt.h 


DevelopmentiSIMNET  :MCC: 
FSE:FSEMac.h 


Calls 

Function 

Where  Described 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

TimeOfFlight 

See  Section  2.17.5.1.11. 

SendFireReguest 

See  Section  2.17.5.1.3. 

SendFPFReguest 

See  Section  2.17.5.1.4. 

SetSchedMission 


EndFireMission 


UpdateBatterySelecfion 


UpdateMissionDisolay 


See  Section  2.17.2.1.8. 


See  Section  2.17.4.3.16. 


See  Section  2.17.1.2.10. 


See  Section  2.17.5.2.2. 


See  Section  2.17.8.5.5. 
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I  Called  By  1 

Function 

Where  Described 

CheckTimers 

See  Section  2.17.5.1.1. 

AdiustEyent 

See  Section  2.17.1.1.2. 

FFEEvent 

See  Section  2.17.1.3.3. 

CommenceFFE 

See  Section  2.17.1.3.4. 

FPFEyent 

See  Section  2.17.1.4.6. 

Start  SchedMission 

See  Section  2.17.4.3.15. 

Table  2.17-122:  FireVolIey  Information. 


2.17.5.1.3  SendFireRequest 

SendFireRequest  tells  the  host  of  a  fire  for  effect  or  an  adjust  fire.  This  function  is  only 
compiled  if  VERSION  is  APPLETALK.  The  function  c^l  is  SendFireRequest(m,  b,  half, 
ammo).  Table  2.17-123  describes  the  parameters  used  and  functions  called  using  this 
function. 


Parameters 


Parameter 


Where  Tynedef  Declared 


DevelopmentiSIMNET  :MCC; 
FSE;FSEMac.h 


Development:SIMNET  :MCC: 
FSE.FSEMac.h 


Standard  C  tvoe. 


Standard  C  type. 


variable 


ab 


errCode 


Internal  Variables 


e 


ABRecHandle 


pointer  to  FSEFireRequest 


Where  Tynedef  Declared 


DevelopmentTHINK  C: 
Mac  #jncludes  .’Appletalk,  h 


DevelopmentiSIMNET  ;MCC: 
FSE;FSEMac.h 


Standard  C  type. 


Function 


NewRr 


NewHandle 


SetUpATPReauest 


ATPReauest 


Calls 


Where  Described 


Standard  Memory  Manaqer  function  for  Macintosh. 


Standard  Memo’"  Manaqer  function  for  Macintosh. 


See  Section  2:^^.^.3.2. 


letalk  Manaqer  function  for  Macintosh. 


Function 


Called  B 


Where  Described 


See  Section  2.17.5.1.2. 


Table  2.17-123:  SendFireRequest  Information. 
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2.17.5.1.4  SendFPFRequest 

SendFPFRequest  tells  the  host  of  a  final  protective  fire  volley.  This  function  is  only 
compiled  if  VERSION  is  APPLETALK.  The  function  call  is  SendFPFRequest(m,  b,  half, 
ammo).  Table  2.17-124  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

m 

pointer  to  Mission 

Development:SIMNET:MCC; 

FSE.FSEMac.h 

b 

pointer  to  Battery 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

half 

int 

Standard  C  type. 

ammo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

ab 

ABRecHandle 

DevelopmentiTHINK  C: 

Mac  #includes;Appletalk.h 

req 

pointer  to  FSEFPFRequest 

Development:SIMNET;MCC: 

FSE:FSEMac.h 

errCode 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

NewRr 

Standard  Memory  Manager  function  for  Macintosh. 

NewHandle 

Standard  Merrxjry  Manager  function  for  Macintosh. 

SetUpATPRequest 

See  Section  2.22.1.3.2. 

ATPRequest 

Standard  Appletalk  Manager  function  for  Macintosh. 

1  Called  By  I 

Function 

Where  Described 

FireVolley 

See  Section  2.17.5.1.2. 

Table  2.17-124:  SendFPFRequest  Information. 


2.17.5.1.5  ApplyToBatterie.s 


ApplyToBatteries  calls  a  function,/,  for  each  battery  half  being  used  by  a  mission,  m.  The 
function  call  is  ApplyToBatteries(f,  m).  Table  2.17-125  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

(f){) 

pointer  to  function  returning 
int 

Standard  C  type. 

m 

pointer  to  Mission 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

L-  \ 
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1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

i 

short 

Standard  C  type. 

j 

short 

Standard  C  type. 

Called  By 

Function 

Where  Described 

BalterySelectionViable 

See  Section  2.17.5.1.9. 

EndFireMission 

See  Section  2.17.1.2.10 

CheckFirinq 

See  Section  2.17.1.3.6. 

FPFEvent 

See  Section  2.17.1.4.6. 

UpdateObserver 

See  Section  2.17.8.5.7. 

Start  SchedMission 

See  Section  2.17.4.3.15. 

Table  2.17-125:  ApplyToBatteries  Information. 


2.17.5.1.6  StartMissionBattery 


StartMissionBattery  begins  a  battery’s  involvement  in  a  mission,  m.  b  and  /la//" describe 
the  battery.  The  function  call  is  StaiiMissionBattery(b,  half,  m).  Table  2.17-126  describes 
the  parameters  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

b 

int 

Standard  C  type. 

half 

int 

Standard  C  type. 

m 

register  pointer  to  Mission 

Developmenf.SIMNET-.MCC; 

FSE:FSEMac.h 

Internal  Variables 

Variable 

Where  Typedef  Declared 

hp 

register  pointer  to  staict  Half 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

1  Calls  1 

Function 

Where  Described 

UpdateBatteryDisplay 

See  Section  2.17.2.1.7. 

1  Called  By  I 

■  Function  1 

Where  Described 

. . . 

See  Section  2.17.8.5.4. 

Table  2.17-126:  StartMissionBattery  Information. 


2.17.5.1.7  EndMissionBattery 

EndMissionBattery  terminates  a  battery’s  involvement  in  a  mission,  m.  b  and  /w// describe 
the  batteiy.  The  function  call  is  EndMissionBattery(b,  half,  m).  Table  2.17-127  describes 
the  parameters  used  and  functions  called  using  this  function. 
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1  Parameters  I 

Parameter 

Where  Typedef  Declared 

b 

int 

Standard  C  type. 

half 

int 

Standard  C  type. 

m 

register  pointer  to  Mission 

DevelopmentiSIMNET  ;MCC; 
FSE:FSEMac.h 

1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

hp 

register  pointer  to  struct  Half 

DevelopmentiSIMNET  ;MCC: 
FSEiFSEMac.h 

1  Calls  1 

Function 

Where  Described 

UpdateBattervDisplav 

See  Section  2.17.2.1.7. 

1  Called  Bv  1 

Function 

Where  Described 

ToggleBatterv 

See  Section  2.17.8.5.4. 

Table  2.17-127:  EndMissionBattery  Information. 
2.17.5.1.8  CheckBattery 


CheckBattery  stops  a  battery  from  firing.  The  function  call  is  CheckBattery(b,  half,  m). 
Table  2.17-128  describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

b 

int 

Standard  C  type. 

half 

int 

Standard  C  type. 

m 

register  pointer  to  Mission 

DevelopmentiSIMNET  iMCCi 
FSEiFSEMac.h 

Table  2.17-128:  CheckBattery  Information. 

2.17.5.1.9  BatterySelectionViable 

BatterySelectionViable  ensures  that  some  battery  has  been  chosen  for  a  given  mission,  m, 
that  the  chosen  batteries  have  some  quantity  of  the  requested  ammunition,  that  the  chosen 
batteries  are  within  range  of  the  target  and  that  only  the  mortars  are  selected  to  fire  white 
phosphorus  rounds.  ApplyToBatteries  uses  the  function  Battery  Viable,  described  below, 
to  determine  if  a  given  battery  is  viable.  The  function  call  is  BatterySelectionViable(m). 
Table  2.17-129  describes  the  parameter  used  and  functions  called  using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Typedef  Declared 

m 

register  pointer  to  Mission 

DevelopmentiSIMNET  iMCCi 
FSEiFSEMac.h 

1  1 
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Return  Values 


Calls 


_ Called  By 


See  Section  2.17.1.1 .1. 


Table  2.17-129:  BatterySelectionViable  Information. 
2.17.5.1.10  BatteryViable 

Battery  Viable  determines  if  a  given  battery,  specified  by  b  and  half,  is  viable  for  a  given 
mission,  m.  The  function  call  is  BatteryViablefb,  half,  m).  Table  2.17-130  describes  the 
parameters  used  and  functions  called  using  this  function. 


See  Section  2.17.1.3.1. 
See  Section  2.17.1.4.6. 
See  Section  2.17.4.3.15 


Function _ 

ShowAdjust _ 

ShowFFE _ 

FPFEvent _ 

StartSchedMission 


Where  Described 


Function _ 

ApplyToBatteries 

ShowCaution 


Where  Described 

See  Section  2.17.5.1.5. 
See  Section  2.22.1.4.1. 


Return  Value _ Type 

batteryViable  int 


Meaning _ 

0  if  battery  not  viable,  1  it  it  is. 
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1  Calls  1 

Function 

Where  Described 

ShowCaution 

See  Section  2.22.1.4.1. 

DistBetween2Pts 

See  Section2.22. 1.23.2. 

Table  2.17«130:  BatteryViable  Information. 


2.17.5.1.11  TimeOfFlight 

TimeOfFlight  returns  the  time  of  flight,  in  seconds,  for  a  round,  described  by  b,  half  md. 
ammo,  to  reach  a  target  location,  location,  from  a  particular  battery.  The  function  call  is 
TimeOfFlight(b,  half,  location,  ammo).  Table  2.17-131  describes  the  parameters  used  and 
functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

b 

pointer  to  Battery 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

half 

int 

Standard  C  type. 

location 

pointer  to  LongPt 

Development  :SIMNET  ilibmac; 
lonaot.h 

ammo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Tvoe 

Where  Typedef  Declared 

Pt 

pointer  to  LongPt 

DevelopmentiSIMNET  ;libmac: 
lonqpt.h 

d 

long 

Standard  C  type. 

1  Return  Values  1 

Return  Value 

Type 

Meaning 

b->perf->timeOfFlight[d] 

int 

Time  of  flight  in  seconds. 

1  Calls  1 

Function 

Where  Described 

DistBetween2Pts 

See  Section  2.22.1.23.2. 

1  Called  By  I 

Function 

Where  Described 

FireVolley 

See  Section  2.17.5.1.2. 

Table  2.17-131:  TimeOfFlight  Information. 


2.17.5.2  units. c 

units.c  contains  routines  that  control  the  assignment  of  artillery  batteries  to  indirect  fire 
missions. 
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2.17.5.2.1  Esta  blishBatterySelection 

EstablishBatterySelection  adjusts  a  matrix  of  fire  unit  selection  checkboxes  to  represent 
only  the  batteries  in  existence.  The  function  call  is  EstablishBatterySelection(di^og, 
firstItemNo).  Table  2.17-132  describes  the  parameters  used  and  functions  called  using  this 
function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

dialog 

OialogRr 

Development:THINK  C: 

Mac  #includes:DialogMgr.h 

firstItemNo 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Tvpedef  Declared 

i 

int 

Standard  C  type. 

i 

int 

Standard  C  type. 

itemNo 

int 

Standard  C  type. 

itemTvpe 

int 

Standard  C  type. 

battery 

register  pointer  to  Battery 

Deyelopment;SIMNET  :MCC: 
FSErFSEMac.h 

item 

Handle 

Development:THINK  C: 

Mac  #includes;MacTypes.h 

box 

Rect 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

pStr 

array  of  256  char 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

GetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

SetIText 

Standard  Dialog  Manager  function  for  Macintosh. 

SetCTitle 

Standard  Control  Manager  function  for  Macintosh. 

OffsetRect 

Standard  Quickdraw  function  for  Macintosh. 

SetDItem 

Standard  Dialog  Manager  function  for  Macintosh. 

HideControl 

Standard  Control  Manager  function  for  Macintosh. 

1  Called  By  1 

Function 

Where  Described 

SetUpFireMission 

See  Section  2.17.1.2.1. 

SetUpFPFMission 

See  Section  2.17.1.4.1. 

ShowSchedMission 

See  Section  2.17.4.3.11. 

Table  2.17-132:  EstablishBatterySelection  Information. 
2.17.5.2.2  UpdateBatterySelection 

UpdateBatterySelection  updates  the  display  of  the  selection  of  batteries  for  performing  a 
fire  mission.  Note  that  this  routine  embeds  assumptions  about  the  order  of  battery  selection 
items  within  fire  dialogs.  The  function  call  is  UpdateBatterySelection().  Table  2.17-133 
describes  the  internal  variables  used  and  functions  called  using  this  function. 
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Variable 


dialog 


iirstltemNo 


itemNo 


Internal  Variables 


reaister  short 


reoister  short 


register  pointer  to  stmct  Half 


DialogRr 


MCC  CSCI 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


DevelopmentiSIMNET  :MCC; 
FSE:FSEMac.h 


Development:THINK  C: 
Mac  #includes:DialoQMar.h 


Standard  C  t 


Standard  C  t 


Function 


GetFireDialooInfo 


GetFPFDialooInfo 


OisableControl 


EnableControl 


Calls 


Where  Described 


See  Section  2.17.1.2.2. 


See  Section  2.17.1.4.2. 


See  Section  2.22.1.7.1. 


See  Section  2.22.1.7.2. 


Function 


ShowFireMission 


ShowFPFMission 


LocalUnitOisoatched 


RemoteUnitOisoatched 


StartSchedMission 


CheckTimers 


FireVolle 


Called  B 


Where  Described 


See  Section  2.17.1.2.4. 


See  Section  2.17.1.4.5. 


See  Section  2.17.3.2.1. 


See  Section  2.17.3.2.3. 


See  Section  2.17.4.3.15. 


See  Section  2.17.5.1.1. 


See  Section  2.17.5.1.2. 


See  Section  2.17.8.5.5. 


Table  2.17>133:  UpdateBatterySelection  Information. 
2.17.5.2.3  WithdrawBattery 

WithdrawBattery  withdraws  a  fire  unit  from  any  mission  in  which  it  is  participating.  The 
function  call  is  WithdrawBattery(battery,  half,  newState).  Table  2.17-134  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 


Parameter 


batte 


half 


newState 


Variable 


hp 


Internal  Variables 


register  pointer  to  struct  Half 


Where  Tvpedef  Declared 


Standard  C  type. 


Standard  C  type. 


Standard  C  t 


Where  Tvoedef  Declared 


Development:SIMNET  :MCC; 
FSE:FSEMac.h 


Function 


Calls 


Where  Described 


See  Section  2.17.8.5.5. 
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1  Called  By  1 

Function 

Where  Described 

RemoteUnitDispatched 

See  Section  2.17.3.2.3. 

ProcessRequest 

See  Section  2.17.8.3.6. 

Table  2.17-134:  WithdrawBattery  Information. 


2.17.6  Appearance  of  FSE  User  Interface 

2.17.6.1  FSE  Pictures 

Development:SIMNET;MCC:FSE;FSE  Pictures 

FSE  Pictures  contains  resources  that  determine  the  appearance  of  the  FSE  application’s 
user  interface. 

2.17.6.2  resource. h 

Development:SIMNET:MCC:FSE:resource.h 

resource.h  defines  the  numbers  of  the  resources  present  in  the  FSE  Pictures  resource  file. 

2.17.7  FSE  Console  Definitions 


2.17.7.1  FSE.h 

Developmenf.SIMNET;MCC:FSE:FSE.h 


FSE.h  defines  the  representation  of  information  communicated  between  the  FSE  Macintosh 
application  and  the  MCC  host. 


2.17.7.2  FSEMac.h 

Development:SIMNET;MCC:FSE:FSEMac.h 


FSEMac.h  defines  types,  constants  and  routines  used  within  the  FSE  Macintosh 
application.  Table  2.17-135  describes  the  variables  used  in  FSEMac.h. 
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1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

missions 

extern  array  of  Mission 

Development:SIMNET  :MCC: 
FSEFSEMac.h 

performance 

extern  array  of  Performance 

Development:SIMNET  :MCC: 
FSEFSEMac.h 

halfNamefir21 

extern  pointer  to  matrix  of  char 

Standard  C  type. 

batteries 

extern  array  of  Battery 

DevelopmentiSIMNET  :MCC: 
FSE:FSEMac.h 

scree  nState 

extern  short 

Standard  C  type. 

popUpDialog 

extern  pointer  to  DialogState 

Deyelopment:SIMNET  ilibmac: 
dialoQ.h 

entry  Dialog 

extern  pointer  to  DialogState 

DeyelopmentiSIMNET  ilibmac; 
dialog. h 

currentMission 

extern  pointer  to  Mission 

Development:SIMNET  :MCC; 
FSE:FSEMac.h 

Table  2.17*135:  FSEMac.h  Variable  Information. 

2.17.7.3  version. h 

Development:SIMNET:MCC:FSE:version.h 

version.h  defines  constants  that  determine  which  version  of  the  FSE  application  is 
compiled. 
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2«17*7.4 

Development:SIMNET  :MCC:FSE:data.c 

data.c  defines  various  data  stmctures  used  by  the  FSE  application,  such  as  tables  of 
information  about  the  performance  of  artillery  batteries.  Table  2.17-136  describes  the 
variables  used  in  data.c. 


1  Variables  '  1 

Variable 

Where  Typedef  Declared 

application 

pointer  to  char 

Standard  C  type. 

authors 

pointer  to  char 

Standard  C  type. 

pointer  to  char 

Standard  C  type. 

mortarPerformance 

Performance 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

howitze  rPe  rf  ormance 

Performance 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

halfNameflf21 

pointer  to  matrix  char 

Standard  C  type. 

batteries 

array  of  maxNumberBatteries 
Battery 

Deyelopment:SIMNET  :MCC: 
FSE:FSEMac.h 

missions 

array  of  maxNumberMissions 
Mission 

DevelopmentrSIMNET.MCC: 

FSE:FSEMac.h 

screenState 

short 

Standard  C  type. 

popUpDialog 

pointer  to  OialogSfate 

Development:SIMNET  ilibmac: 
dialoQ.h 

entryDialog 

pointer  to  DialogState 

DevelopmentiSIMNET  ;libmac: 
dialoQ.h 

currentMission 

pointer  to  Mission 

Development:SIMNET:MCC: 

FSErFSEMac.h 

distanceCheat 

short 

Standard  C  type. 

Table  2.17>136:  data.c  Variable  Information. 


2.17.8  FSE  Console  Software 


2.17.8.1  file.c 

Development:SIMNET:MCC:FSE:file.c 

file.c  contains  routines  for  creating  and  reading  Macintosh  files  holding  lists  of  indirect  fire 
targets  and  scheduled  missions.  Table  2.17-137  describes  the  variables  used  in  file.c. 


1  Variables  1 

Variable 

Where  Typedef  Declared 

badMissions 

pointer  to 

SchedMissionHandle 

Development;SIMNET  :MCC: 
FSEiFSEMac.h 

errStr 

array  of  128  char 

Standard  C  type. 

bytesOut 

int 

Standard  C  type. 

Table  2.17-137:  file.c  Variable  Information. 
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2.17.8.1.1  NewPresets 

NewPresets  allows  the  user  to  set  up  new  preset  data  in  the  files  holding  the  indirect  fire 
target  lists  and  scheduled  mission  lists,  llie  function  call  is  NewPresets().  Table  2.17-138 
describes  the  internal  variables  used  and  functions  called  using  this  function. 


Varlabie 


resCode 


Internal  Variables 


e 


OSErr 


Where  Tvoedef  Declared 


Development:THINK  C: 
Mac  #jncludes;MacTyDes.h 


Function 


WiDeFireTable 


WioeFPFTable 


WioeSchedTable 


ReadTerrainMa 


Calls 


Where  Described 


See  Section  2.17.8.1.4. 


See  Section  2.17.8.1.13. 


See  Section  2.17.8.1.16. 


See  Section  2.17.8.1.20. 


See  Section  2.17.8.1.8. 


Called  B 


Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17-138:  NewPresets  Information. 


2.17.8.1.2  LoadPresets 


LoadPresets  reads  in  the  preset  target  files  which  contain  canned  target  and  scheduled 
mission  data.  The  function  call  is  LoadPresets().  Table  2.17-139  describes  the  internal 
variables  used  and  functions  called  using  this  function. 


Internal  Variables 

Variable 

Where  Typedef  Declared 

where 

Point 

DevelopmentiTHINK  C: 

Mac  #includes:MacTypes.h 

IheReply 

SFReply 

DevelopmentTHINK  C: 

Mac  #includes:StdFilePka.h 

resCode 

OSErr 

DevelopmentiTHINK  C: 

Mac  #includes;MacTvpes.h 

theinfo 

FInfo 

Development:THINK  C; 

Mac  #includes:FileMqr.h 

theFile 

int 

Standard  C  type. 

theTypeList 

SFTypeList 

DevelopmentTHINK  C; 

Mac  #includes:StdFilePkq.h 
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Calls 

Function 

Where  Described 

SFGetFile 

Standard  Standard  File  Packaoe  function  for  Macintosh. 

FSOpen 

Standard  File  Manaoer  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

CheckConfi 


WipeFireTable 


WioeFPFTable 


WioeSchedTable 


ReadlerrainMa 


ReadFireTaroets 


ReadFPFTaraets 


ReadSchedMissions 


FSCIose 


FlushVol 


See  Section  2.17.8.1.4. 


See  Section  2.17.8.1.6. 


See  Section  2.17.8.1.13. 


See  Section  2.17.8.1.16. 


See  Section  2.17.8.1.20. 


See  Section  2.17.8.1.8. 


See  Section  2.17.8.1.12. 


See  Section  2.17.8.1.15. 


See  Section  2.17.8.1.18. 


Standard  File  Manaoer  function  for  Macintosh. 


Standard  File  Manaoer  function  for  Macintosh. 


Called  B 


Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17>139:  LoadPresets  Information. 

2.17.8.1.3  SavePresets 

SavePresets  saves  a  preset  file  containing  Fire  Target,  FPFTarget,  and  Scheduled  Mission 
data.  The  function  call  is  SavePresets().  Table  2.17-140  describes  the  internal  variables 
used  and  functions  called  using  this  function. 


Internal  Variables 


Variable 

Tvoe 

Where  Typedef  Declared 

where 

Point 

DevelopmentiTHINK  C: 

Mac  #includes:MacTvpes.h 

theReply 

SFReply 

DevelopmentTHINK  C: 

Mac  #includes:StdFilePkq.h 

resCode 

OSErr 

Development  THINK  C: 

Mac  #includes:MacTypes.h 

theinfo 

FInfo 

DevelopmentTHINK  C; 

Mac  #includes:FileMor.h 

theFile 

int 

Standard  C  type. 
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1  Calls  1 

Function 

Where  Described 

SFPutFile 

Standard  Standard  File  Packaqe  function  for  Macintosh. 

GetFInfo 

Standard  File  Manaqer  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

Create 

Standard  File  Manaqer  function  for  Macintosh. 

FSOpen 

Standard  File  Manaqer  function  for  Macintosh. 

GetConfiQ 

See  Section  2.17.8.1.4. 

SaveConfiq 

See  Section  2.17.8.1.5. 

SaveFireTarqets 

See  Section  2.17.8.1.11. 

SaveFPFTarqets 

See  Section  2.17.8.1.14. 

SaveSchedMissions 

See  Section  2.17.8.1.17. 

SetEOF 

Standard  File  Manaqer  function  for  Macintosh. 

FSCIose 

Standard  File  Manaqer  function  for  Macintosh. 

FlushVol 

Standard  File  Manaqer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17-140:  SavePresets  Information. 


2.17.8.1.4  GetConfig 

GetConfig  lists  the  configuration  options  database  version  and  name  for  the  preset  file. 
The  function  call  is  GetConfigQ.  Table  2.17-141  describes  the  functions  calling  this 
function. 


1  Called  By  1 

Function 

Where  Described 

NewPresets 

See  Section  2.17.8.1.1. 

LoadPresets 

See  Section  2.17.8.1.2. 

SavePresets 

See  Section  2.17.8.1.3. 

Table  2.17-141:  GetConfig  Information. 


2.17.8.1.5  SaveConfig 

SaveConfig  saves  the  configuration  of  the  preset  file  specified  by  the  parameter  theFile. 
This  routine  is  called  by  SavePresets()  to  write  out  the  file.  The  function  call  is 
SaveConfig(theFile).  Table  2.17-142  describes  the  parameters  used  and  functions  called 
using  this  function. 


1  Parameters  | 

Parameter 

Where  Typedef  Declared 

theFile 

int 

Standard  C  type. 
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Variable 


resCode 


count 


confiaSize 


Internal  Variables 


OSErr 


Where  Tyoedef  Declared 


DevelopmentTHINK  C: 
Mac  #includes;MacTvDes.h 


Standard  C  t 


Standard  C  tvoe. 


Return  Values 


Return  Value 


-1 


Meanin 


Write  error  in  function. 


Function 


FSWrite 


ShowCaution 


Calls 


Where  Described 


Standard  File  Manaaer  function  for  Macintosh. 


See  Section  2.22.1.4.1. 


Called  B 


Function 

Where  Described 

SavePresets 

See  Section  2.17.8.1.3. 

Table  2.17-142:  SaveConfig  Information. 

2.17.8.1.6  CheckConfig 

CheckConfig  checks  the  validity  of  the  preset  file  specified  by  the  parameter  theFile.  This 
routine  is  called  by  LoadPresets()  to  read  in  the  preset  file.  The  function  call  is 
CheckConfig(theFile).  Table  2. 17-143  describes  the  parameters  used  and  functions  called 
using  this  function. 


Parameter 


theFile 


Variable 


count 


confiaSize 


resCode 


configFile 


Parameters 


Internal  Variables 


e 


int 


int 


stnjct  config 


Where  Tvpedef  Declared 


Standard  C  type. 


Where  Typedef  Declared 


Standard  C  type. 


Standard  C  t 


Standard  C  type. 


Development:SIMNET  :MCC: 
FSE:file.c 


Calls 

Function 

Where  Described 

FSRead 

Standard  File  Manaaer  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

Function 


LoadPresets 


Called  B 


Where  Described 


See  Section  2.17.8.1.2. 


Table  2.17-143:  CheckConfig  Information. 
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2.17.8.1,7  SaveTerrainMap 

SaveTerrainMap  saves  terrain  map  data  to  the  file  specified  by  theFile.  The  function  call  is 
SaveTerrainMapO.  Table  2.17-144  describes  the  internal  variables  used  and  functions 
called  using  this  fiinction. 


1  Internal  Variables  1 

Variable 

Where  Typedef  Declared 

mapSize 

int 

Standard  C  type. 

count 

lonq 

Standard  C  type. 

astr 

array  of  128  char 

Standard  C  type. 

where 

Point 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

theReply 

SFReply 

DevelopmentrTHINK  C: 

Mac  #includes:StdFilePka.h 

resCode 

OSErr 

DevelopmentrTHINK  C: 

Mac  #includes;MacTvpes.h 

theinfo 

FInfo 

DevelopmentrTHINK  Cr 

Mac  #includesrRleMar.h 

theFile 

int 

Standard  C  type. 

tbytesOut 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

SFPutFile 

Standard  Standard  File  Packaoe  function  for  Macintosh. 

GetFInfo 

Standard  File  Manaaer  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

Create 

Standard  File  Manaaer  function  for  Macintosh. 

FSOpen 

Standard  File  Manaaer  function  for  Macintosh. 

FSWrite 

Standard  File  Manaaer  function  for  Macintosh. 

SetEOF 

Standard  File  Manaaer  function  for  Macintosh. 

FSCIose 

Standard  File  Manaaer  function  for  Macintosh. 

FlushVol 

Standard  File  Manaaer  function  for  Macintosh. 

1  Called  Bv  1 

Function 

Where  Described 

MainEventLoop 

See  Section  2.17.8.3.3. 

Table  2,17-144;  SaveTerrainMap  Information. 
2.17.8.1.8  ReadTerrainMap 


ReadTerrainMap  reads  the  data  file  containing  the  terrain  map.  The  function  call  is 
ReadTerrainMap(query).  Table  2.17-145  describes  the  parameter  used  and  functions  called 
using  this  function. 


1  Parameters  | 

1  Parameter 

Type 

Where  Typedef  Declared  I 

query 


int 


Standard  C  tyoe. 
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Variable 


count 


mapSize 


theReply 


resCode 


theinfo 


theTypeList 


vRefNum 


dnveNum 


theFile 


freeBvtes 


volName 


Internal  Variables 


e 


int 


SFReply 


OSErr 


SFTypeList 


Str255 


Where  Typedef  Declared 


Standard  C  t 


Standard  C  t 


Development:THINK  C: 

Mac  #includes:StdFilePka.h 


Development:THINK  C: 
Mac  #includes:MacTvpes.h 


Development:THINK  C: 
Mac  #includes;FileMQr.h 


Development;THINK  C: 

Mac  rWncludes.StdFilePka.h 


Standard  C  t 


Standard  C  type. 


Standard  C  t 


Standard  C  t 


DevelopmenttTHINK  C: 
Mac  #jncludes;MacTvpes.h 


Devetopment:THINK  C: 
Mac  #jncludes:MacTypes.h 


Return  Value 


-1 


Return  Values 


Type 


int 


Meanin 


Unsuccessful. 


Calls 

Function 

Where  Described 

ShowCaution 

See  Section  2.22.1.4.1. 

SFGetFile 

Standard  Standard  File  Packaae  function  for  Macintosh. 

FSOpen 

Standard  File  Manaoer  function  for  Macintosh. 

GetVol 

Standard  File  Manaoer  function  for  Macintosh. 

FSRead 

Standard  File  Manaoer  function  for  Macintosh. 

FSCIose 

Standard  File  Manaoer  function  for  Macintosh. 

FlushVol 

Standard  File  Manaoer  function  for  Macintosh. 

Called  B 


Function 

Where  Described 

NewPresets 

See  Section  2.17.8.1.1. 

LoadPresets 

See  Section  2.17.8.1.2. 

Table  2.17-145:  ReadTerrainMap  Information. 


2.17.8.1.9  SaveStatus 


SaveStatus  saves  the  status  of  the  mortar  batteries  to  the  data  file  specified  by  the  parameter 
theFile.  The  function  call  is  SaveStatus(theFile).  Table  2.17-146  describes  the  parameter 
used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

theFile 

int 

Standard  C  type. 
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1  Internal  Variables  1 

Variable 

Tvoe 

Where  Tvpedef  Declared 

resCode 

int 

Standard  C  type. 

count 

Iona 

Standard  C  type. 

astr 

array  of  128  Char 

Standard  C  type. 

batsize 

int 

Standard  C  type. 

missSize 

int 

Standard  C  type. 

Calls 

Function 

Where  Described 

FSWrite 

Standard  File  Manaaer  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

Table  2.17-146:  SaveStatus  Information. 


2.17.8.1.10  ReadStatus 


ReadStatus  reads  the  status  of  the  mortar  batteries  from  the  data  file  specified  by  the 
parameter  theFile.  The  function  call  is  ReadStatus(theFile).  Table  2.17-147  describes  the 
parameter  used  and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Type 

Where  Typedef  Declared 

theFile 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Where  Typedef  Declared 

count 

lonq 

Standard  C  type. 

batSize 

int 

Standard  C  type. 

missSize 

int 

Standard  C  type. 

resCode 

int 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

FSRead 

Standard  File  Manaaer  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

Table  2.17-147:  ReadStatus  Information. 


2.17.8.1.11  SaveFireTargets 


SaveFireTargets  saves  Fire  Target  data  to  the  data  file  specified  by  the  parameter  theFile. 
The  function  call  is  SaveFireTargets(theFile).  Table  2.17-148  describes  the  parameter  used 
and  functions  called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

theFile 

int 

Standard  C  type. 

1  1 
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Variable 


resCode 


ft 


astr 


count 


numTaraets 


fireTableFieW 


Internal  Variables 


e 


int 


FireTargetHandle 


array  of  128  char 


extern  ScrollTableFieldDefn 


Where  Typedef  Declared 


Standard  C  t 


DevelopmentiSIMNET  :MCC: 
FSE:FSEMac.h 


Standard  C  type. 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Development:SIMNET  ilibmac: 
scroll.h  


Function 


FSWrite 


ShowCaution 


Calls 


Where  Described 


Standard  File  Manaaer  function  for  Macintosh. 


See  Section  2.22.1.4.1. 


Called  B 


Function 

Where  Described 

SavePresets 

See  Section  2.17.8.1.3. 

Table  2.17<148:  SaveFireTargets  Information. 

2.17.8.1.12  ReadFireTargets 

ReadFireTargets  reads  Fire  Targets  data  from  the  file  specified  by  the  parameter  theFile. 
The  function  call  is  ReadFireTargets(theFile).  Table  2.17-149  describes  the  parameter  used 
and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

theFile 

int 

Standard  C  type. 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

resCode 

int 

Standard  C  type. 

ft 

FireTargetHandle 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

oidjt 

FireTargetHandle 

Development:SIMNET  :MCC; 
FSEFSEMac.h 

astr 


count 


numTaraets 


fireTableFiekj 


FireT  argetDescriptor 


array  of  128  char 


extern  ScrollTableFieldDefn 


Development:SIMNET  :MCC: 
FSEFSEMac.h 


Standard  C  type. 


Standard  C  tyoe. 


Standard  C  type. 


Standard  C  type. 


DevelopmentiSIMNET  ilibmac; 
scroll.h 
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1  Calls  1 

Function 

Where  Described 

FSRead 

Standard  File  Manager  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

NewFireTaraet 

See  Section  2.17.4.1.1. 

InstallFireTaroet 

See  Section  2.17.4.1.10. 

. 

Called  By 

Function 

Where  Described 

LoadPresets 

See  Section  2.17.8.1.2. 

Table  2.17-149:  ReadFireTargets  Information. 


2.17.8.1.13  WipeFireTable 

WipeFireTable  wipes  out  the  current  Fire  Target  Table.  This  routine  is  called  by  in  order  to 
clear  out  old  Fire  Targets  data.  NewPresetsO  calls  this  routine  in  preparation  for  the  user  to 
set  up  new  Fire  Target  Table,  and  LoadPresets()  calls  this  routine  in  preparation  for  reading 
in  new  canned  Fire  Target  data.  The  function  call  is  WipeFireTableQ.  Table  2.17-150 
describes  the  internal  variables  used  and  functions  called  using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

resCode 

int 

Standard  C  type. 

ft 

FireTargetHandle 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

remjt 

FireTargetHandle 

Developmenf.SIMNET-.MCC. 

FSE:FSEMac.h 

astr 

array  of  128  char 

Standard  C  type. 

fireTableField 

extern  ScrollTableFieldDefn 

Development  :SIMNET  :libmac: 
scroll.h 

Calls 

Function 

Where  Described 

UnhookFireTarqet 

See  Section  2.17.4.1.15. 

RemoveScrollTableEntrv 

See  Section  2.22.1.28.1. 

Called  By 

Function 

Where  Described 

NewPresets 

See  Section  2.17.8.1.1. 

LoadPresets 

See  Section  2.17.8.1.2. 

Table  2.17-150:  WipeFireTable  Information. 

2.17.8.1.14  SaveFPFTargets 

SaveFPFTargets  saves  the  Final  Protective  Fire  Targets  data  to  the  data  file  specified  by  the 
parameter  theFile.  The  function  call  is  SaveFPFTargets(theFile).  Table  2.17-151 
describes  the  parameter  used,  errors  returned  and  functions  called  using  this  function. 
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Parameter 


theFile 


Parameters 


Variable 


resCode 


fpft 


astr 


count 


numTaroets 


Internal  Variables 


e 


mt 


FPFT  argetHandle 


array  of  128  char 


fpfTableField 


extern  ScrollTableFieldDefn 


MCCCSCI 


Where  Typedef  Declared 


Standard  C  t 


Where  Tvoedef  Declared 


Standard  C  t 


Development:SIMNET  :MCC: 
FSE:FSEMac.h 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


Standard  C  t 


Development:SIMNET  ilibmac; 
scroll,  h 


Function 


FSWrite 


ShowCaution 


Calls 


Where  Described 


Standard  File  Manaoer  function  for  Macintosh. 


See  Section  2.22.1.4.1. 


Called  B 


Function 

Where  Described 

SavePresets 

See  Section  2.17.8.1.3. 

2.17.8.1.15 


Table  2.17-151  SaveFPFTargets  Information. 
ReadFPFTargets 


ReadFPFTargets  reads  Final  Protective  Fire  Targets  data  from  the  file  specified  by  the 
parameter  theFile.  The  function  call  is  ReadFP^argets(theFile).  Table  2.17-152 
describes  the  parameter  used  and  functions  called  using  Ais  function. 


Parameter 


theFile 


Variable 


resCode 


fpft 


oidjpft 


astr 


count 


numTaroets 


Parameters 


Internal  Variables 


e 


int 


FPFTargetHandle 


FPFTargetHandle 


FPFT  arget  Descriptor 


array  of  128  char 


fpfTableField 


extern  ScrollTableFieldDefn 


Where  Typedef  Declared 


Standard  C  type. 


Where  Typedef  Declared 


Standard  C  t 


Development:SIMNET  :MCC: 
FSE:FSEMac.h 


Deyelopment:SIMNET  :MCC: 
FSE:FSEMac.h 


DevelopmentiSIMNET  ;MCC; 
FSE:FSEMac.h 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


Standard  C  type. 


Development.SIMNET.libmac; 

scroll.h 
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Calls 

Function 

Where  Described 

FSRead 

Standard  File  Manager  function  for  Macintosh. 

ShowCaution 

See  Section  2.22.1.4.1. 

NewFPFTarqet 

See  Section  2.17.4.2.1. 

InstallFPFTarget 

See  Section  2.17.4.2.9. 

Called  By 

Function 

Where  Described 

Load  Presets 

See  Section  2.17.8.1.2. 

Table  2.17<152:  ReadFPFTargets  Information. 


2.17.8.1.16  WipeFPFTable 

WipeFPFTable  wpes  out  the  current  Final  Protective  Fire  Targets  Table.  This  routine  is 
called  in  order  to  clear  out  old  FPFTargets  data.  NewPresets()  calls  this  routine  in 
preparation  for  the  user  to  set  up  new  H^FTarget  Table,  and  I^adPresets()  calls  this  routine 
in  preparation  for  reading  in  new  canned  FPFTarget  data.  The  function  c^l  is 
WipeFPFTableO.  Table  2.17-153  describes  the  internal  variables  used  and  functions  called 
using  this  function. 


1  Internal  Variables  I 

Variable 

Type 

Where  Typedef  Declared 

resCode 

int 

Standard  C  type. 

fpft 

FPFT?vrgetF  andle 

Developmenf.SIMNET-.MCC ; 
FSE.FSEMac.h 

remjpft 

FPFTargetHandle 

Development:SiMNET  :MCC; 
FSE:FSEMac.h 

astr 

array  of  128  char 

Standard  C  type. 

fpfTableField 

extern  ScrollTableFieldDefn 

Development:SIMNET  :libmac: 
scroll,  h 

Calls 

Function 

Where  Described 

RemoveScrollTableEntry 

See  Section  2.22.1.28.1. 

Called  By 

Function 

Where  Described 

NewPresets 

See  Section  2.17.8.1.1. 

LoadPresets 

See  Section  2.17.8.1.2. 

Table  2.17-153:  WipeFPFTable  Information. 
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2.17.8.1.17  SaveSchedMissions 

SaveSchedMissions  saves  Scheduled  Missions  data  to  the  file  specified  by  the  parameter 
theFile.  The  function  call  is  SaveSchedMissions(theFile).  Table  2.17-154  describes  the 
parameter  used  and  functions  called  using  this  function. 


Parameter 


theFile 


Variable 


resCode 


Schedt 


astr 


count 


numMissions 


Parameters 


Internal  Variables 


e 


SchedMissionHandle 


array  of  128  char 


taroetNum 


schedTableField 


extern  ScrollTableFiekJDefn 


Where  Typedef  Declared 


Standard  C  t 


Where  Tvoedef  Declared 


Standard  C  t 


Development:SIMNET  :MCC; 
FSE:FSEMac.h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  tvoe. 


Standard  C  t 


DevelopmentrSIMNET  ilibmac; 
scroll.h 


Function 


FSWrite 


ShowCaution 


Calls 


Where  Described 


Standard  File  Manaqer  function  for  Macintosh. 


See  Section  2.22.1.4.1. 


Called  B 


Function 

Where  Described 

SavePresets 

See  Section  2.17.8.1.3. 

Table  2.17-154:  SaveSchedMissions  Information. 

2.17.8.1.18  ReadSchedMissions 

ReadSchedMissions  reads  Scheduled  Missions  data  from  the  file  specified  by  the  parameter 
theFile.  The  function  call  is  ReadSchedMissions(theFile).  Table  2.17-155  describes  the 
parameters  used  and  functions  called  using  this  function. 
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Variable 


resCode 


Schedt 


old  Schedt 


astr 


count 


numMissions 


Internal  Variables 


e 


int 


SchedMissionHandie 


SchedMissionHandle 


SchedMissionOescriptor 


array  of  128  char 


aBadMission 


taraetNum 


schedTableFiekj 


extern  ScrollTableFieldDefn 


MCC  CSCI 


Where  Typedef  Declared 


Standard  C  t 


Development:SIMNET:MCC: 

FSEiFSEMac.h 


Development:SIMNET  :MCC; 
FSE:FSEMac.h 


Development;SIMNET  :MCC; 
FSE:FSEMac.h 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


DevelopmentrSIMNET  :libmac; 
scroll.h 


Function 


FSRead 


ShowCaution 


InstallScrollTableEnt 


CheckSchedMission 


SetSchedMission 


Calls 


Where  Described 


Standard  File  Manaoer  function  for  Macintosh. 


See  Section  2.22.1.4.1. 


See  Section  2.22.1.21.1. 


See  Section  2.17.8.1.19. 


See  Section  2.17.4.3.16. 


Called  B 


Function 

Where  Described 

LoadPresets 

See  Section  2.17.8.1.2. 

Table  2.17*155  ReadSchedMissions  Information. 

2.17.8.1.19  CheckSchedMission 

CheckSchedMission  checks  the  Scheduled  Missions  Table  specified  by  smPtr.  For  any 
missions  which  were  scheduled  for  a  time  previous  to  the  current  time  and  were  not  started, 
-1  is  returned.  The  function  call  is  CheckSchedMission(smPtr).  Table  2.17-156  describes 
the  parameter  used  and  functions  called  using  this  function. 


Parameter 


smRr 


Variable 


now 


Parameters 


SchedMissionHandle 


Internal  Variables 


e 


unsioned  Ion 


Where  Typedef  Declared 


DevelopmentiSIMNET  :MCC; 
FSE:FSEMac.h 


Where  Typedef  Declared 


Standard  C  tvoe. 


Return  Values 


Return  Value 


-1 


Meanin 


Mission  not  ready. 
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1  Calls  1 

Function 

Where  Described 

GetDateTime 

Standard  Operating  System  Utility  function  for  Macintosh. 

Called  Bv 

Function 

Where  Described 

ReadSchedMissions 

See  Section  2.17.8.1.18. 

Table  2.17-156:  CheckSchedMission  Information. 

2.17.8.1.20  WipeSchedTable 

WipeSchedTable  wipes  out  the  current  Scheduled  Missions  Table.  This  routine  is  called  in 
order  to  clear  out  old  Scheduled  Missions  data.  NewPresetsO  calls  this  routine  in 
preparation  for  the  user  to  set  up  new  Scheduled  Missions  Table,  and  Lx>adPresets()  calls 
this  routine  in  preparation  for  reading  in  new  canned  Scheduled  Missions  data.  The 
function  call  is  WipeSchedTable().  Table  2.17-157  describes  the  internal  variables  used 
and  functions  call^  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

resCode 

int 

Standard  C  type. 

Schedt 

SchedMissionHandte 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

rem_Schedt 

SchedMissionHandle 

Development:SIMNET:MCC: 

FSE:FSEMac.h 

astr 

array  of  128  char 

Standard  C  type. 

schedTableField 

extern  ScrollTableFieldDefn 

Deyelopment;SIMNET  :libmac: 
scroll.h 

Calls 

Function 

Where  Described 

RemoveScrollTableEntry 

See  Section  2.22.1.28.1. 

Called  By 

Function 

Where  Described 

NewPresets 

See  Section  2.17.8.1.1. 

Load  Presets 

See  Section  2.17.8.1.2. 

Table  2.17-157: 


WipeSchedTable  Information. 
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2.17.8.2  load.c  - 

Development:  SIMNET  :MCC:FSE:load.c 


load.c  loads  canned  data  into  application  data  structures,  in  the  standalone,  demo  version  of 
the  FSE  application.  These  functions  are  only  compiled  if  VERSION  is  FULDAGAP. 
Table  2.17-158  describes  the  variables  used  in  load.c. 


1  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

cannedFireTargets 

array  of  CannedFireTarget 

DevelopmentiSIMNET  :MCC: 
FSE:load.c 

cannedFPFT argets 

array  of  CannedFPFTarget 

Development:SIMNET:MCC: 

FSErload.c 

Table  2.17-158:  load.c  Variable  Information. 

2.17.8.2.1  LoadCannedTerrainMap 

LoadCannedTerrainMap  loads  canned  information  about  the  exercise  terrain.  The  function 
call  is  LoadCannedTerrainMapO.  Table  2.17-159  describes  the  function  which  calls  this 
function. 


1  Called  By  1 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

Table  2.17-159:  LoadCannedTerrainMap  Information. 


2.17.8.2.2  LoadCannedStatus 


LoadCannedStatus  loads  canned  mission  and  battery  status.  The  function  call  is 
LoadCannedStatusQ.  Table  2.17-160  describes  the  internal  variables  used  and  functions 
called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

battery 

unsiqned  short 

Standard  C  type. 

half 

unsiqned  short 

Standard  C  type. 

ammo 

unsiqned  short 

Standard  C  type. 

map 

MapCoordinates 

Development  SIMNET :libmac: 
map.h 

Calls 

Function 

Where  Described 

StrinqToMapCoordinates 

See  Section  2.22.1.26.1. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

Table  2.17-160: 


LoadCannedStatus  Information. 
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2.17.8.2.3  LoadCannedFireTargets 

LoadCannedFireTargets  loads  precanned  target  number  assignments.  The  function  call  is 
LoadCannedFireTargetsO.  Table  2.17-161  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

ct 

pointer  to  CannedFireTarget 

Development;SIMNET  ;MCC; 
FSEtload.c 

t 

FireTargetHandle 

DevelopmentiSIMNET  ;MCC: 
FSEtFSEMac.c 

Calls 

Function 

Where  Described 

NewFireTaraet 

See  Section  2.17.4.1.1. 

St  ri  ngT  oM  apCoordi  nates 

See  Section  2.22.1.26.1. 

InstallFireTaraet 

See  Section  2.17.4.1.10. 

Called  Bv 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

Table  2.17>161:  LoadCannedFireTargets  Information. 
2.17.8.2.4  LoadCannedFPFTargets 

LoadCannedFPFTargets  loads  precanned  FPF  targets.  The  function  call  is 
LoadCannedFPFTargetsO.  Table  2.17-162  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

ct 

pointer  to  CannedFPFTarget 

DevelopmentiSIMNET  :MCC: 
FSEiload.c 

t 

FPFTargetHandle 

DevelopmentiSIMNET  iMCCi 
FSEiFSEMac.h 

Calls 

Function 

Where  Described 

NewFPFTarqet 

See  Section  2.17.4.2.1. 

St  ri  nqToM  apCoordi  nates 

See  Section  2.22.1.26.1. 

InstallFPFTarqet 

See  Section  2.17.4.2.9. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

Table  2.17-162:  LoadCannedFPFTargets  Information. 
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2.17.8.3  main.c 

Development:SIMNET:MCC:FSE:main.c 

main.c  contains  the  CAS  application's  progr^  entry  point  and  main  event  loop.  Table 
2.17-163  describes  the  variables  used  in  main.c. 


1  Variables  1 

Variable 

1  Where  Typedef  Declared  I 

startupComplete 

char 

. . nil 

Table  2.17-163:  main.c  Variable  Information. 


2.17.8.3.1  main 


main  is  the  program  entry  point  for  the  FSE  console  application.  The  function  call  is 
mainQ.  Table  2. 17-164  describes  the  internal  variable  used  and  functions  called  using  this 
function. 


1  Internal  Variables  I 

Variable 

Where  Typedef  Declared 

my  Event 

EventRecord 

DevetopmentTHINK  C: 

Mac  #includes;EventMqr.h 

1  Calls  1 

Function 

Where  Described 

Setup 

See  Section  2.17.8.6.1. 

ProcessRequesf 

See  Section  2.17.8.3.6. 

SetUpAppleTalk 

See  Section  2.22.1.3.1. 

DownloadTerrainMap 

See  Section  2.22.1.3.4. 

DownloadGunData 

See  Section  2.17.8.3.2. 

LoadCannedTerrainMap 

See  Section  2.17.8.2.1. 

LoadCannedStatus 

See  Section  2.17.8.2.2. 

SetUpMenus 

See  Section  2.17,8.4.1. 

AddFileMenu 

See  Section  2.17.8.4.2. 

Install  Clock 

See  Section  2.22.1.6.4. 

SetUpBatterv 

See  Section  2.17.2.1.2. 

SetUpStatus  Window. 

See  Section  2.17.2.2.1. 

SetUpFireMission 

See  Section  2.17.1.2.1. 

SetUpFireTable 

See  Section  2.17.4.1.2 

SetUpFPFMission 

See  Section  2.17.1.4.1. 

SetUpFPFTable 

See  Section  2.17.4.2.2. 

SetUpSchedTable 

See  Section  2.17.4.3.2. 

LoadCannedFireTarqets 

See  Section  2.17.8.2.3. 

LoadCannedFPFT  arqets 

See  Section  2.17.8.2.4. 

ShowStatusWindow 

See  Section  2.17.2.2.2. 

MainEventLoop 

See  Section  2.17.8.3.3. 

Table  2.17-164:  main  Information. 
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2.17.8.3.2  DownloadGunData 

DownloadGunData  downloads  information  about  the  fire  units.  This  function  is  compiled 
only  if  VERSION  is  APPLETALK.  The  function  call  is  DownloadGunDataQ.  Table 
2.17-165  describes  the  internal  variable  used  and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Tvoe 

Where  Tvpedef  Declared 

my  Event 

EventRecord 

DevelopmentTHINK  C: 

Mac  #includes;EventMQr.h 

Calls 

Function 

Where  Described 

GetNextEvent 

Standard  Toolbox  Event  Manaqer  function  for  Macintosh. 

NetworkEventHandler 

See  Section  2.22.1.3.5. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

Table  2.17*165.'  DownloadGunData  Information. 

2.17.8.3.3  MainEventLoop 

MainEventLoop  sits  in  a  loop  forever  fielding  incoming  events  to  the  FSE  console.  The 
function  call  is  MainEventL^pQ.  Table  2.17-166  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

distanceCheat 

extern  short 

Standard  C  type. 

myEvent 

EventRecord 

DevelopmentTHINK  C: 

Mac  #includes:EventMqr.h 

Calls 

Function 

Where  Described 

CheckTimers 

See  Section  2.17.5.1.1. 

UpdateClock 

See  Section  2.22.1.6.2. 

SystemTask 

Standard  Desk  Manaqer  function  for  Macintosh. 

GetNextEvent 

Standard  Toolbox  Event  Manaqer  function  for  Macintosh. 

AddFileMenu 

See  Section  2.17.8.4.2. 

ShowDisplace 

See  Section  2.17.3.1.1. 

ATPCIoseSocket 

Standard  Appletalk  Manaqer  function  for  Macintosh. 

ExitToShell 

Standard  Seqment  Loader  function  for  Macintosh. 

SaveTerrainMap 

See  Section  2.17.8.1.7. 

ShowVersions 

See  Section  2.22.1.44.1. 

Adjust  ScreenState 

See  Section  2.17.8.3.4. 

WindowEvent 

See  Section  2.22.1.46.2. 

Network  Eve  nt  H  andle  r 

See  Section  2.22.1.3.5. 

1  1 
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1  Called  By  I 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

Table  2.17-166:  MainEventLoop  Information. 


2.17.8.3.4  AdjustScreenState 

AdjustScreenState  updates  the  knowledge  about  the  state  of  a  screen  on  a  window,  w, 
becoming  active.  The  function  call  is  AdjustScreenState(w).  Table  2.17-167  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameter 


w 


Parameters 


register  WindowRr 


Where  Tvoedef  Declared 


Development:THINK  C: 

Mac  #includes;WindowMar.h 


Variable 


c 


Internal  Variables 


e 


Where  Tvpedef  Declared 


Standard  C  tvoe. 


Calls 

Function 

Where  Described 

EnableMenus 

See  Section  2.17.8.4.4. 

Function 


MainEventLoo 


Called  B 


Where  Described 


See  Section  2.17.8.3.3. 


Table  2.17-167:  AdjustScreenState  Information. 

2.17.8.3.5  ShowHelp 

ShowHelp  puts  up  a  help  screen.  Dialogs  that  are  part  of  the  FSE  application  have  help 
topics  associated  with  them  that  are  numbered  the  same  as  the  dialogs’  DLOG  resources. 
The  function  call  is  ShowHelp().  Table  2.17-168  describes  the  internal  variables  used  and 
functions  called  using  this  function. 


1  Internal  Variables  I 

1  Variable 

Type 

Where  Typedef  Declared 

int 

Standard  C  type. 

^ _ 

register  long 

Standard  C  type. 

Calls 

Fuf.ction 

Where  Described 

GetWRefCon 

Standard  Window  Manager  function  for  Macintosh 

showhelp 

See  Section  2.22.1.19.4. 
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1  Called  By  I 

Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

Table  2.17>168:  ShowHeip  Information. 

2.17.8.3.6  ProcessRequest 

ProcessRequest  processes  a  request  received  from  the  MCC  host.  This  function  is 
compiled  only  when  VERSION  is  APPLETALK.  The  function  call  is 
ProcessRequest(hdl).  Table  2.17-169  describes  the  parameters  used,  and  functions  called 
using  this  function. 


I  Parameters  I 

Parameter 

Where  Typedef  Declared 

hdl 

register  Handle 

DevelopmentTHINK  C: 

Mac  #includes;macTypes.h 

Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

P 

register  Rr 

DevelopmentTHINK  C: 

Mac  #includes;MacTypes.h 

b 

register  pointer  to  Battery 

Development:SIMNET  :MCC: 
FSE:FSEMac.h 

i 

short 

Standard  C  type. 

errCode 

int 

Standard  C  type. 

I  Calls  I 

Function 

Where  Described 

SetDateTime 

Standard  Operating  Sytem  Utility  function  for  Macintosh. 

See  Section  2.17.5.2.3. 

PointToMapCoordinates 

See  Section  2.22.1.26.2. 

ThrowDisplace 

See  Section  2.17.3.1.2. 

See  Section  2.17.2.1.7. 

UpdateAmmoDisplav 

See  Section  2.17.2.1.8. 

ATPResponse 

Standard  Appletalk  Manager  function  for  Macintosh. 

Restart 

Standard  Operating  System  Utility  function  for  Macintosh. 

RemoteUnitDispatched 

See  Section  2.17.3.2.3. 

RemoteUnitArrived 

See  Section  2.17.3.2.4. 

I  Called  By  I 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

Table  2.17-169:  ProcessRequest  Information. 

2.17.8.4  menu.c 

Development.SIMNET:MCC:FSE:menu.c 


menu.c  implements  the  menus  presented  by  the  FSE  application.  Table  2.17-170  describes 
the  variables  used  in  menu.c. 
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1  Variables  1 

Variable 

Where  Typedef  Declared 

menu 

array  of  numberMenues  struct 
menus 

Development:SIMNET  :MCC; 
FSE:menu.c 

Table  2.17-170:  menu.c  Variable  Information. 
2.17.8.4.1  SetUpMenus 

SetUpMenus  creates  a  menu  bar.  The  function  call  is  SetUpMenusQ.  Table  2.17-171 
describes  the  internal  variable  used  and  the  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Where  Tvoedef  Declared 

i 

reqister  short 

Standard  C  type. 

1  Calls  1 

Function 

Where  Described 

InitMenus 

Standard  Menu  Manaaer  function  for  Macintosh. 

InsertMenu 

Standard  Menu  Manaqer  function  for  Macintosh. 

DrawMenuBar 

Standard  Menu  Manaqer  function  for  Macintosh. 

Oisableltem 

Standard  Menu  Manaqer  function  for  Macintosh. 

SetMenuHandler 

See  Section  2.22.1.46.1. 

1  Called  Bv  1 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

Table  2.17-171:  SetUpMenus  Information. 

2.17.8.4.2  AddMenuFile 

AddMenuFile  inserts  a  menu  file  into  the  menu  bar.  The  function  call  is  AddMenuFile(). 
Table  2.17-172  describes  the  functions  called  using  this  function. 


1  Calls  1 

Function 

Where  Described 

InsertMenu 

Standard  Menu  Manaqer  function  for  Macintosh. 

GetMenu 

Standard  Menu  Manaqer  function  for  Macintosh. 

DrawMenuBar 

Standard  Menu  Manaqer  function  for  Macintosh. 

Called  By 

Function 

Where  Described 

main 

See  Section  2.17.8.3.1. 

MainEventLoop 

See  Section  2.17.8.3.3. 

Table  2.17-172:  AddFileMenu  Information. 
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2.17.8.4.3  FutureMissionTest 


FuturcMissionTest  is  used  to  determine  if  all  selected  scheduled  missions  are  future 
missions.  The  function  call  is  FutureMissionTest(defn,  selection).  Table  2.17-173 
describes  the  parameters  used  by  this  function. 


1  Parameters  I 

Parameter 

Where  Typedef  Declared 

defn 

pointer  to 

ScrollTableFieldDefn 

Development:SIMNET  :libmac; 
scroll. h 

selection 

ScrollT  ableEntryHandle 

DevelopmentiSIMNET  :libmac: 
scroll. h 

Table  2.17-173:  FutureMissionTest  Information. 


2.17.8.4.4  EnableMenus 


EnableMenus  enables  and  disables  menu  items  according  to  what  is  currently  on  the  screen. 
The  function  call  is  EnableMenus().  Table  2.17-174  describes  the  internal  variables  used 
and  functions  called  using  this  function. 


1  Internal  Variables  1 

Variable 

Type 

Where  Typedef  Declared 

tireTablePield 

extern  ScrollTableFieldDefn 

Development:SIMNEt;libmac; 
scroll. h 

fpfTableField 

extern  ScrollTableFieldDefn 

Development:SIMNET  :libmac: 
scroll. h 

schedTableFiekJ 

extern  ScrollTableFieldDefn 

Development:SIMNET:libmac; 
scroll. h 

i 

reqister  short 

Standard  C  type. 

defn 

pointer  to 

ScrollT  ableFieldDef  n 

DevelopmentiSIMNET  ;libmac: 
scroll. h 

Calls 

Function 

Where  Described 

Disableltem 

Standard  Menu  Manager  function  for  Macintosh. 

Enableltem 

Standard  Menu  Manager  function  for  Macintosh. 

MapScrollTableSelected 

See  Section  2.22.1.33.1. 

MortarBattery 

Macro  defined  in  FSEMac.h.  See  Section  2.17.7.2. 

Called  By 

Function 

Where  Described 

MenuCommand 

See  Section  2.17.8.4.5. 

FireTableSelect 

See  Section  2.17.4.1.5. 

FPFTableSelect 

See  Section  2.17.4.2.4. 

GchedTableSelect 

See  Section  2.17.4.3.4. 

SetSchedMission 

See  Section  2.17.4.3.16. 

Adjust  ScreenState 

See  Section  2.17.8.3.4. 

Table  2.17-174:  EnableMenus  Information. 
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2.17.8.4.5  MenuCommand 


MenuCommand  performs  a  command  chosen  from  a  menu.  The  function  call  is 
MenuCommand(mResult).  Table  2.17-175  describes  the  parameter  used  and  functions 
called  using  this  function. 


1  Parameters  I 

Parameter 

Where  Tvpedef  Declared 

mResult 

unsigned  long 

Standard  C  type. 

1  internal  Variables  I 

Variable 

Tvoe 

Where  Tvpedef  Declared 

fireTableDialog 

extern  pointer  to  DialogState 

Devetopment;SIMNET  :libmac; 
dialog. h 

fpfTableDialog 

extern  pointer  to  DialogState 

Development  :SIM  NET  :libmac: 
dialog.h 

schedTableDialog 

extern  pointer  to  DialogState 

DevelopmentiSIMNET  ilibmac: 
dialog.h 

fireTableField 

extern  ScrollTableFieldDefn 

Development;SIMNET  :libmac: 
scroll,  h 

fpfTableField 

extern  ScrollTableFieldDefn 

DevelopmentiSIMNET  :libmac: 
scroll. h 

schedTableFiekj 

extern  ScrollTableFieldDefn 

DevelopmentiSIMNET  ilibmac: 
scroll,  h 

theMenu 

int 

Standard  C  type. 

theltem 

int 

Standard  C  type. 
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Function 


ShowHel 


ShowStatusWindow 


ShowFireTable 


ShowFPFTable 


ShowSchedTable 


UndoFireTaraet 


UndoFPFTarqet 


UndoSchedMission 


UndoOisDiace 


ShowFireTaraet 


NewFireTarqet 


ShowFPFTarqet 


NewFPFTarqet 


ShowSchedMission 


NewSchedMission 


MaoScrollTableSelected 


EnableMenus 


ShowNewFireMission 


ShowNewFPFMission 


ShowOisolace 


Save  Presets 


LoadPresets 


NewPresets 


HiliteMenu 


Calls 


Where  Described 


See  Section  2.17.8.3.5. 


See  Section  2.17.2.2.2. 


See  Section  2.17.4.1.4. 


See  Section  2.17.4.2.3. 


See  Section  2.17.4.3.3. 


See  Section  2.17.4.1.14. 


See  Section  2.17.4.2.13. 


See  Section  2.17.4.3.14. 


See  Section  2.17.3.1.6. 


See  Section  2.17.4.1.11. 


See  Section  2.17.4.1.1. 


See  Section  2.17.4.2.10. 


See  Section  2.17.4.2.1. 


See  Section  2.17.4.3.11. 


See  Section  2.17.4.3.1. 


See  Section  2.22.1.33.1. 


See  Section  2.17.8.4.4. 


See  Section  2.17.1.5.1. 


See  Section  2.17.1.4.3. 


See  Section  2.17.3.1.1. 


See  Section  2.17.8.1.3. 


See  Section  2.17.8.1.2. 


See  Section  2.17.8.1.1. 


Standard  Menu  Manaqer  function  for  Macintosh. 


Table  2.17*175:  MenuCommand  Information. 

2.17.8.5  mission. c 

Development:SIMNET;MCC:FSE:mission.c 

mission.c  contains  routines  for  creating  new  fire  mission  descriptors  and  updating  the 
display  of  a  mission's  status. 

2.17.8.5.1  NewMission 

NewMission  finds  an  unused  mission  descriptor  and  returns  it  in  m.  The  function  call  is 
NewMission(type).  Table  2.17-176  describes  the  parameter  used  by  this  function. 


Parameters 


Parameter 


e 


D7S 


lEH:! 


Where  Tvpedef  Declared 


Standard  C  tvoe. 


Internal  Variables 

Variable 

Type 

Where  Typedef  Declared 

m 

register  pointer  to  Mission 

DevelopmentiSIMNET  ;MCC; 
FSE:FSEMac.h 

Standard  C  t 


Standard  C  tvoe. 
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Return  Value 


Return  Values 


Type _ 


pointer  to  Mission 


IIS 


inter  to  Mission 


Called  B 


MCC  CSCI 


Meanin 


Maximum  numbers  of  missions 
already  in  use. 


Unused  mission  descnptor. 


Function 

Where  Described 

ShowNewFPFMission 

See  Section  2.17.1.4.3. 

ShowNewFireMission 

See  Section  2.17.1.5.1. 

Table  2.17-176:  NewMission  Information. 

2.17.8.5.2  EndMission 

EndMission  frees  up  a  mission  descriptor,  m.  The  function  call  is  EndMission (m).  Table 
2.17-177  describes  the  parameter  used  and  functions  called  using  this  function. 


Parameter 


m 


Function 


RedrawMissionIcon 


IBTII 


Parameters 


e  Where  Typedef  Declared 


register  pointer  to  Mission  DevelopmentiSIMNET ;MCC; 

FSE:FSEMac.h 


Calls 


Where  Described 


See  Section  2.17.2.2.5. 


Called  B 


Function 

Where  Described 

EndFireMission 

See  Section  2.17.1.2.10. 

FPFEvent 

See  Section  2.17.1.4.6. 

NewMissionEvent 

See  Section  2.17.1.5.2. 

StartSchedMission 

See  Section  2.17.4.3.15. 

Table  2.17-177:  EndMission  Information. 

2.17.8.5.3  OpenMission 

OpenMission  opens  an  icon  to  display  the  status  of  a  mission,  m.  The  function  call  is 
C)penMission(m).  Table  2.17-178  describes  the  parameter  used  and  functions  called  using 
this  function. 


582 


BBN  Systems  and  Technologies 


MCC  CSCI 


1  Called  By  I 

Function 

Where  Described 

StatusEveniHandler 

See  Section  2.17.2.2.4. 

Table  2.17*178:  OpenMission  Information. 


2.17.8.5.4  ToggleBattery 

ToggleBattery  toggles  the  allocation  of  a  battery,  described  by  b  and  half,  to  a  current 
mission.  The  function  call  is  ToggleBattery(b,  half).  Table  2.17-179  describes  the 
parameters  used,  and  functions  called  using  this  function. 


Parameter 


Parameters 


Ein 


Where  Tyoedef  Declared 


Standard  C  tvoe. 


Standard  C  tvoe. 


Function 


StartMissionBatte 


EndMissionBatte 


Calls 


Where  Described 


See  Section  2.17.5.1.6. 


See  Section  2.17.5.1.7. 


Called  B 


Function 

Where  Described 

FireEvent 

See  Section  2.17.1.2.5. 

FPFEvent 

See  Section  2.17.1.4.6. 

Table  2.17-179:  ToggleBattery  Information. 
2.17.8.5.5  UpdateMissionDisplay 


UpdateMissionDisplay  updates  the  screen  for  a  mission,  m,  whose  status  may  have 
changed.  The  function  call  is  UpdateMissionDisplay(m).  Table  2.17-180  describes  the 
parameters  used  and  functions  called  using  this  function. 


Parameters 

Parameter 

Type 

Where  Typedef  Declared 

m 

register  pointer  to  Mission 

Development:SIMNET  :MCC; 
FSEiFSEMac.h 

Calls 

Function 

Where  Described 

RedrawMissionIcon 

See  Section  2.17.2.2.5. 

UpdateBatterySelection 

See  Section  2.17.5.2.2. 

UpdateFirePialoq _ See  Section  2.17.1.2.7. 

UpdateFPFDialOQ _ See  Section  2.17.1.4.9. 
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1  Called  Bv  1 

Function 

Where  Described 

AdjustEvent 

See  Section  2.17.1.1.2. 

FFEEvent 

See  Section  2.17.1.3.3. 

CommenceFFE 

See  Section  2.17.1.3.4. 

CancelAtCommand 

See  Section  2.17.1.3.5. 

CheckFirina 

See  Section  2.17.1.3.6. 

FPFEvent 

See  Section  2.17.1.4.6. 

Start  SchedMission 

See  Section  2.17.4.3.15. 

FireVollev 

See  Section  2.17.5.1.2. 

WithdrawBattery 

See  Section  2.17.5.2.1. 

Table  2.17>180:  UpdateMissionDispIay  Information. 


2.17.8.5.6  UpdateMissionState 


UpdateMissionState  updates  the  display  of  the  mission  :tate,  m.  The  function  call  is 
UpdateMissionState(m).  Table  2.17-181  describes  the  parameter  used  and  functions  called 
using  this  function. 


1  Parameters  | 

Parameter 

Type 

Where  Tvpedef  Declared 

m 

register  pointer  to  Mission 

Development.SIMNET  :MCC: 
FSE:FSEMac.h 

Calls 

Function 

Where  Described 

RedrawMissionIcon 

See  Section  2.17.2.2.5. 

UpdateFi  restate 

See  Section  2.17.1.2.8. 

UpdateFPFState 

Called  Bv 

Function 

Where  Described 

CheckTimers 

See  Section  2.17.5.1.1. 

Table  2.17-181:  UpdateMissionState  Information. 


2.17.8.5.7  UpdateObserver 

UpdateObserver  updates  the  display  of  an  Observer’s  Call  Sign  everywhere.  This  function 
is  called  by  the  libmac  dialog  code  as  a  field  validation  function  associated  with  the 
Observer  field  in  the  mission  status  dialog.  The  function  call  is  UpdateObserver(dialog,  fp, 
str).  Table  2.17-182  describes  the  parameters  used  and  functions  called  using  this 
function. 


Parameters 

Parameter 

Type 

Where  Tvpedef  Declared 

dialog 

pointer  to  DialogState 

DevelopmentiSIMNET  :libmac: 
dialog. h 

fp 

pointer  to  TextFieldDefn 

Developmenl.SIMNET.libmac; 

dialOQ.h 

str  ^  I  pointer  to  char  |  Standard  C  type. 
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Return  Values 

Return  Value 

Type 

Meaning 

1 

int 

Always  returned. 

Calls 

Function 

Where  Described 

RedrawMissionIcon 

See  Section  2.17.2.2.5. 

ApplyToBatteries 

See  Section  2.17.5.1.5. 

Table  2.17*182:  UpdateObserver  Information. 


2.17.8.6  setup. c 

Development:SIMNET:MCC;FSE:setup.c 

setup.c  initializes  the  FSE  application  at  start-up. 

2.17.8.6.1  Setup 

SetUp  initializes  the  SIMNET  FireSupportElement  application.  The  toolbox  is  intialized. 
^e  SIMNET  Resources  and  FSE  Pictures  files  are  opened.  The  Help  Manager  is 
initialized.  Storage  is  allocated  for  pop-up  dialogs.  The  table  of  missions  and  table  of 
batteries  are  initi^zed.  The  function  call  is  SetUpQ.  Table  2.17-183  describes  the  internal 
variables  used  and  functions  called  using  this  function. 


Variable 


errCode 


finalTicks 


Internal  Variables 


reqister  short 


Where  Tvoedef  Declared 


Standard  C  t 


Standard  C  t 


Standard  C  type. 


Calls 

Function 

Where  Described 

InitToolbox 

See  Section  2.22.1.20.1. 

Zoomlnit 

See  Section  2.22.1.47.1. 

OpenResFile 

Standard  Resource  Manager  function  for  Macintosh. 

h^^init _ 

Svstb'mFailure 


NewFir 


Standard  Operating  System  Utility  function  for  Macintosh. 


Standard  Segment  Loader  function  for  Macintosh. 


See  Section  2.22.1.8.2. 


See  Section  2.22.1.19.1. 


See  Section  2.22.1.8.1. 


Standard  Memory  Manager  function  for  Macintosh. 


Called  B 


Where  Described 


See  Section  2.17.8.3.1. 


Table  2.17-183:  SetUp  Information. 
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2.18  The  CAS  (Close  Air  Support)  Console 


CAS  (Close  Air  Support)  Console 
1.18 


CAS  Console 
Definitions 
1.18.1 


-CAS.h 

1.18.1.1 

-CASMac.h 

1.18.1.2 

-version. h 

1.18.1.3 


CAS  Console 
Software 
1.18.2 


•condition.c 

1.18.2.1 

.diaiog.c 

1.18.2.2 

-limits.c 

1.18.2.3 


Appearance 
of  CAS 
Console  User 
Interface 
11.18.3 


■CAS  Pictures 
1.18.3.1 


-data.c 

1.18.1.4 


-load.c 

1.18.2.4 


■j’esource.h 

1.18.1.5 


-main.c 

1.18.2.5 


-ditl.h 

1.18.1.6 


-mission.c 

1.18.2.6 


•schedule.c 

1.18.2.7 

-setup.c 

1.18.2.8 


Figure  2.18-1:  CAS  (Close  Air  Support)  Console  Structure. 


